DOFSystem DOFSystem_AddActivateInterestListener DOFSystem_AddRouteListener DOFSystem_BeginInterest DOFSystem_BeginQuery DOFSystem_CreateObject DOFSystem_CreateProviderInterfaceList DOFSystem_CreateProviderRoute DOFSystem_CreateState DOFSystem_Destroy DOFSystem_IsInterestRequested DOFSystem_Query DOFSystem_RemoveActivateInterestListener DOFSystem_RemoveRouteListener DOFSystem_WaitProvider DOFSystemConfig DOFSystemConfigBuilder DOFSystemList_Destroy DOFSystemState

DOFObject DOFSystem_WaitProvider ( const DOFSystem  sys, const DOFObjectID  objectID, uint32  interfaceIDCount, const DOFInterfaceID  interfaceIDs[], uint32  timeout  ) Wait for a provider providing at least the given set of interfaces to become available in the system, and return a new, valid DOFObject for it. The Broadcast ID may be used as a wildcard (to return the first object found). The matching logic uses the same logic as DOFObjectID_MatchesAtLeast, so additional attributes may be present on the resulting Object (e.g., an activate service may add a Provider attribute). If there are multiple matches, the first one found will be returned. This is a simplified form of DOFSystem_Query or DOFSystem_BeginQuery, followed by DOFSystem_CreateObject on the first match. There is no request to the network to identify additional objects that may be available. The DOFObject returned may be limited by the Interest operations that exist (see DOFSystem_BeginInterest). If the Object is not available within the timeout period, the function will return NULL. Resource Management: This function allocates resources that must later be freed by calling DOFObject_Destroy. Parameters sys The System. This must not be NULL. objectID The Object ID on which to wait. This should not be NULL, and should not represent a multicast Object ID. It may be the Broadcast ID to return the first object found. interfaceIDCount The number of Interfaces to wait for on the Object. This should be greater than 0. interfaceIDs The list of Interfaces to wait for on the Object. This should not be NULL, and should not contain a NULL or the Wildcard ID. timeout The duration to wait for the Object and Interfaces to be available, in milliseconds. Returns A new DOFObject representing the desired Object. Exceptions NULL is returned if an invalid parameter was detected, or the Object was not available within the given timeout. See Also DOFSystem_BeginInterest