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

DOFRouteInfo DOFSystem_CreateProviderRoute ( const DOFSystem  sys, const DOFObjectID  objectID, const DOFInterfaceID  interfaceID  ) Return the current route information for the best, compatible provider (if any) given an Object ID and Interface ID. Resource Management: This function allocates resources that must later be freed by calling DOFRouteInfo_Destroy. Parameters sys The System. This must not be NULL. objectID The Object ID of the desired provider. This should not be NULL, and should not be the Broadcast or a multicast Object ID. interfaceID The Interfaces ID of the desired provider. This should not be NULL, and should not be the Wildcard Interface ID. Returns The DOFRouteInfo for the best compatible provider, or NULL if a match could not be found. Exceptions NULL is returned if an invalid parameter is detected, or insufficient resources are available to create the route information.