Attempt to open an OAP session with a remote node.
DOSContext must be cleared, and the following fields set prior to this call: ObjectID InterfaceID and/or Alias
The following DOSContext fields may optionally be set, prior to this call: Address, Session
DOSOperation_SetTimeout should be called to set an appropriate timeout for the operation. Other DOSOperation calls may be used to configure the operation.
In a secure Session, permission checking will be performed only if DOSContext.Binding is set.
Upon DOSSTATUS_SUCCESS, sessionOid will be a DOSObjectID that should be used for any future OAP requests on the session. This must later be freed by the application (the memory hint used is DOSMEMORYHINT_OBJECTID).
- Parameters
-
| sessionType | A DOSInterfaceID to indicator either a specific interface a provider should provide on this session, or a more generic interface to be used as a flag for the type of session requested. |
| sessionObjectID | An output parameter to store a unique DOSObjectID used for the OAP Session. This will only have a valid value if this function returns DOSSTATUS_SUCCESS. |
- Returns
DOSSTATUS_SUCCESS on success
