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

boolean DOFOperation_WaitComplete ( const DOFOperation  op, uint32  timeout, DOFException *  pException  ) Wait for the Operation to complete. This blocks the caller until the operation completes (including by timeout or cancel), or the timeout of this wait expires, whichever occurs first. During this wait, information continues to be passed to the callbacks as necessary. If the Operation completes or times out during this call, the callback is called for the last time prior to this call returning, and the return value will be TRUE. If this call's timeout expires first, then the return value will be FALSE. The time specified in this call does not affect the Operation itself; it only specifies the maximum time this call will pend waiting for the operation to be complete. Avoid using the same timeout as the operation, since this can introduce a race condition (the operation may or may not actually complete before this wait does). Instead, use DOF_TIMEOUT_NEVER. The maximum time this call can wait is the minimum of the operation's time remaining and timeout. 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). Note If this call returns TRUE, it is guaranteed that all callbacks associated with the operation have been called and have returned. Parameters op The Operation. This must not be NULL. timeout The maximum time to wait, in milliseconds. [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. Return values TRUE if the operation has completed. If pException is not NULL, it will contain the same exception (if any) given to the operation's Complete callback. FALSE if the operation has not completed within the specified time, or an error occurred. If pException is not NULL, it will be set as follows: A DOFErrorException containing DOFERROR_TIMEOUT if the operation is still in progress (the wait timed out). A DOFErrorException containing DOFERROR_INSUFFICIENT_RESOURCES if internal resources could not be created to process this request. See Also DOFOperation_IsComplete