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
- 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
UPNP_E_INVALID_ACTION: This action is not valid.
UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.
[in] The handle of the control point sending the action. |
[in] The action URL of the service. |
[in] The type of the service. |
[in] This parameter is ignored and must be |
[in] The DOM document for the SOAP header. This may be |
NULL if the header is not required.
[in] The DOM document for the action to perform on this device. |
[in] Pointer to a callback function to be invoked when the operation completes. |
[in] Pointer to user data that to be passed to the callback when invoked. |