Download Manual

API Reference Manual
2.18 UPnP_GetRequestedServiceId
FUNCTION
Extracts service identifier from an action/subscription request.
SUMMARY
const UPNP_CHAR* UPnP_GetRequestedServiceId ( void* eventStruct,
enum e_UPnPDeviceEventType eventType )
void* eventStruct
Pointer to a UPnPActionRequest or a UPnPSubscriptionRequest
structure depending on the type of request.
enum e_UPnPDeviceEventType
eventType
Indicated the type of control point’s request to handle.
If eventType == UPNP_DEVICE_EVENT_ACTION_REQUEST, it
indicates an action request
If eventType ==
UPNP_DEVICE_EVENT_SUBSCRIPTION_REQUEST, it indicated
a subscription request type.
DESCRIPTION
This function is used by application’s event handler (device callback) to handle an action or a subscription
request invoked by a control point on this device. This function extracts service identifier for a service
targetted by control point’s action or subscription request.
RETURNS
const UPNP_CHAR*
Pointer to string containing service identifier
NULL
Operation failed
SEE ALSO
UPnP_GetRequestedDeviceName ( ), UPnP_GetRequestedActionName ( ), UPnP_GetArgValue ( )
58