Queries the state of a state variable of a service on another device.
- The use of this function is deprecated by the UPnP Forum.
This is a synchronous call.
A positive return value indicates a SOAP error code, whereas a negative return code indicates an SDK error code.
- 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 not a valid URL.
UPNP_E_INVALID_DESC: The XML document was not found or it does not contain a valid XML description.
UPNP_E_INVALID_PARAM: StVarVal is not a valid pointer or VarName or ActionUrl is
UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.
UPNP_SOAP_E_INVALID_VAR: The given variable is invalid according to the device.
[in] The handle of the control point. |
[in] The URL of the service. |
[in] The name of the variable to query. |
[out] The pointer to store the value for VarName. The SDK allocates this string and the caller needs to free it using ixmlFreeDOMString. |