OpenDOF Project
DOSStatus DOSDPSSession_Open ( void  )

Open an DPS session with a remote node using using the configuration in DOSContext.

DOSDPSSession_Initialize must be called before calling DOSDPSSession_Open.

DOSContext must be cleared, and the following fields set prior to this call: Address, Session

The following DOSContext fields may optionally be set, prior to this call: Operation

DOSDPSSession_SetTimeout should be called to set an appropriate timeout for the operation. Other DOSOperation and DOSSession calls may be used to configure the session.

This call will not block until the sesson is open, the Opened or Closed DPS session callback specified in DOSConfig will be called when the session is opened or fails to open.

Note
For secure DPS sessions DOSSecurityConfig must be defined, the security desire must be set appropriately, the permissions should be set, and the authentication server address or session may need to be set.
There are protocol specified timeouts that will apply for opening a session. Additionally the specified operation timeout will apply if the timeout specified is shorter than the protocol specified timeouts and the operation is saved.
Refer to the configure callback in DOSDPSSessionCallbacks_t for information on inbound sessions.
Returns
DOSStatus DOSSTATUS_SUCCESS will be returned if the request to open an DPS session was sent successfully, or the status will indicate a failure to send the request.
core-c-cos Version 7.0.1 Build 0
2018-02-08