Register a set of callbacks for Providing (or implementing) an Interface on an Object.
This notifies the system that the given Interface is now available on the given Object. For the duration of the DOFOperation, the Provider callbacks will be used to handle requests to the Object for the given Interface. As with any DOFOperation, this "operation" can be extended or cancelled.
- Resource Management:
- This function allocates resources that must later be freed by calling DOFOperation_Destroy.
- Parameters
-
| obj | The DOFObject on which to Provide. This should not be NULL and should represent a single object (neither the broadcast nor a multicast object). |
| iface | The DOFInterface to Provide. This should not be NULL. |
| timeout | The duration for the Provide "operation", in milliseconds. The timeout begins after the operation has been processed and sent to appropriate connections. |
| callback | The callbacks to use while providing this Interface on this Object. This may be NULL (or any of its functions) if they do not apply or do not need to be implemented for the provider. |
| context | Application context data associated with the "operation". This may be NULL. |
- Returns
- A reference to the new provide DOFOperation.
- Exceptions
-
| NULL | is returned if , or
- an invalid parameter is detected; or
- insufficient resources exist to create the operation; or
- this node is already providing for iface on obj.
|
