DOFObject DOFObject_Advertise DOFObject_BeginDefine DOFObject_BeginGet DOFObject_BeginInvoke DOFObject_BeginProvide DOFObject_BeginRegister DOFObject_BeginSession DOFObject_BeginSet DOFObject_BeginSubscribe DOFObject_Changed DOFObject_Copy DOFObject_CreateInterfaceList DOFObject_Define DOFObject_Destroy DOFObject_Get DOFObject_GetObjectID DOFObject_GetSystem DOFObject_Invoke DOFObject_IsInterestRequested DOFObject_IsSignalRequired DOFObject_Set DOFObject_Signal

DOFInterface DOFObject_Define ( const DOFObject  self, const DOFInterfaceID  interfaceID, DOFOperationControl  config, uint32  timeout, DOFException *  pException  ) 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 DOFInterface_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. [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. Returns The Interface retrieved. Exceptions NULL is returned and pException is set with one of the following errors: DOFERROR_ILLEGAL_ARGUMENT if an invalid argument is detected. DOFERROR_NOT_FOUND if the Interface Definition could not be found in the network. DOFERROR_INSUFFICIENT_RESOURCES if the Interface could not be allocated.