DOFOperation DOFOperation_Cancel DOFOperation_Destroy DOFOperation_GetContext DOFOperation_GetException DOFOperation_GetTimeRemaining DOFOperation_IsAcknowledged DOFOperation_IsCancelled DOFOperation_IsComplete DOFOperation_SetTimeout DOFOperation_WaitAcknowledged DOFOperation_WaitComplete DOFOperationBridgeConfig DOFOperationBridgeConfigBuilder DOFOperationDefine_GetControl DOFOperationDefine_GetInterfaceID DOFOperationDefine_GetObject DOFOperationDefine_WaitInterface DOFOperationFilter DOFOperationFilterBuilder DOFOperationGet_GetControl DOFOperationGet_GetObject DOFOperationGet_GetProperty DOFOperationGet_GetResult DOFOperationGet_WaitResult DOFOperationInterest_GetControl DOFOperationInterest_GetInterestLevel DOFOperationInterest_GetInterfaceID DOFOperationInterest_GetObjectID DOFOperationInterest_GetSystem DOFOperationInvoke_GetControl DOFOperationInvoke_GetMethod DOFOperationInvoke_GetObject DOFOperationInvoke_GetResult DOFOperationInvoke_WaitResult DOFOperationProvide_GetInterface DOFOperationProvide_GetObject DOFOperationQuery_GetQuery DOFOperationQuery_GetSystem DOFOperationRegister_GetControl DOFOperationRegister_GetEvent DOFOperationRegister_GetObject DOFOperationSession_GetControl DOFOperationSession_GetInterface DOFOperationSession_GetObject DOFOperationSession_GetSessionType DOFOperationSession_SetDataTransform DOFOperationSession_WaitSession DOFOperationSet_GetControl DOFOperationSet_GetObject DOFOperationSet_GetProperty DOFOperationSet_GetResult DOFOperationSet_WaitResult DOFOperationSubscribe_GetControl DOFOperationSubscribe_GetMinPeriod DOFOperationSubscribe_GetObject DOFOperationSubscribe_GetProperty

DOFObject DOFOperationSession_WaitSession ( const DOFOperation  op, uint32  timeout, DOFException *  pException  ) Wait for a Session Operation to be accepted, and return a DOFObject for the session. If the operation has already been accepted or is completed, this returns immediately as defined below. Resource Management: This function allocates resources that must later be freed by calling DOFObject_Destroy. This blocks the caller until the operation is accepted or an exception is returned, the operation times out or is cancelled, or the timeout of this wait expires, whichever occurs first. The time specified in this call has no relationship to the Operation itself; it only specifies how long this call will block the caller. It is not safe to use this call if the operation's complete callback can result in a call to DOFOperation_Destroy (refer to that function's documentation for more information). Parameters op The Operation. This must not be NULL and must represent a valid Session Operation. timeout The maximum time to wait for a result, in milliseconds. A value of 0 returns immediately. [out] pException An Exception. If pException is NULL, no exception is reported. Otherwise, the output is either a DOFException, or NULL to indicate no exception occurred. DOFException_Destroy must be called to destroy the returned DOFException, if any. Returns The DOFObject, representing the new Session created by the Session Operation, or NULL if a session object cannot be returned. There are two cases in which a session object cannot be returned: If the operation failed with an exception, the exception is reported via pException, which will be non-NULL. If the operation has not been accepted within the specified timeout, or completes without a session object within the specified timeout, pException will represent a DOFERROR_TIMEOUT.