|
Request that an Interface definition be located in the network and retrieved.
There is no guarantee that a definition can be found.
- Resource Management:
- This function allocates resources that must later be freed by calling DOFOperation_Destroy.
- Parameters
-
self | The Object on which to make the request. This must not be NULL. |
interfaceID | The identifier for the Interface to be defined. This should not be NULL, and should not be the wildcard IID. |
config | Configuration options for the request operation (NULL for default configuration). |
timeout | The maximum amount of time to wait for the definition, in milliseconds. The timeout begins after the operation has been processed and sent to appropriate connections. |
callback | The callback through which responses and the completion notification will be received. This may be null to ignore notification of the received interface. The definition can be retrieved by calling DOFOperationDefine_WaitInterface. |
context | Application context data associated with the asynchronous operation. |
- Returns
- A representation of the define operation.
- Exceptions
-
NULL | is returned if
- an invalid parameter is detected; or
- insufficient resources exist to create the operation.
|
|