Logo Search packages:      
Sourcecode: libupnp4 version File versions  Download package

EXPORT_SPEC int UpnpSendActionExAsync ( UpnpClient_Handle  Hnd,
const char *  ActionURL,
const char *  ServiceType,
const char *  DevUDN,
IXML_Document Header,
IXML_Document Action,
Upnp_FunPtr  Fun,
const void *  Cookie 

Sends a message to change a state variable in a service, generating a callback when the operation is complete.

See UpnpSendAction for comments on positive return values. These positive return values are sent in the event struct associated with the UPNP_CONTROL_ACTION_COMPLETE event.

An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: ActionUrl is an invalid URL.
  • UPNP_E_INVALID_DEVICE: DevUDN is an invalid device.
  • UPNP_E_INVALID_PARAM: Either Fun is not a valid callback function or ServiceType, Act, or ActionUrl is NULL.
  • UPNP_E_INVALID_ACTION: This action is not valid.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.
Hnd  [in] The handle of the control point sending the action.
ActionURL  [in] The action URL of the service.
ServiceType  [in] The type of the service.
DevUDN  [in] This parameter is ignored and must be NULL.
Header  [in] The DOM document for the SOAP header. This may be NULL if the header is not required.
Action  [in] The DOM document for the action to perform on this device.
Fun  [in] Pointer to a callback function to be invoked when the operation completes.
Cookie  [in] Pointer to user data that to be passed to the callback when invoked.

Generated by  Doxygen 1.6.0   Back to index