IDataServer5.StartTempShutdown (METH)

METHOD StartTempShutdown : UDINT

This method can be used for temporarily shutting down a dataserver connection. Due to the reason that this shutdown might take some cycles, the user of this method should wait until the operation is finished. This can be determined using the callback <see>cbShutdownDone</see>. Calls to this method must be protected by calling BeginDataConfiguration/EndDataConfiguration around this call. To resume the normal operation of the datasource call the method <see>ResumeAfterTempShutdown</see>.

InOut:

Scope

Name

Type

Comment

Return

StartTempShutdown

UDINT

Input

pstDataSource

POINTER TO STRING

The name of the datasource, must not be NULL

cbShutdownDone

ICallback

An optional callback that will be triggered when the shutdown is finished. The callback parameter will be a pointer to a <see>ITempShutdownResult</see>. Please remember that the callback might be called from a different task then the call to <see>StartTempShutdown</see>. Please remember that the given object must live at least until the callback is called. Don’t pass a function local variable for this parameter!