IWSDDeviceHost::RetireService (Compact 2013)
3/26/2014
This method unregisters a service object that was registered using IWSDDeviceHost::RegisterService and removes the service from the device host metadata.
Syntax
HRESULT RetireService(
LPCWSTR pszServiceId
);
Parameters
- pszServiceId
[in] The ID of the service to be removed.
Return Value
The following table shows the possible error code return values.
Error code |
Description |
|---|---|
S_OK |
This method completed successfully. |
E_POINTER |
pszServiceId is NULL. |
E_INVALIDARG |
The length in characters of pszServiceId exceeds WSD_MAX_TEXT_LENGTH (8192), or pszServiceId was not found in the list of registered services. |
E_FAIL |
The method failed. It may have failed because the host has not been initialized. Call IWSDDeviceHost::Init to initialize a device host. |
Remarks
The device host releases its reference to the service object after the service is unregistered. The service object will not receive callbacks after RetireService has completed.
Requirements
Header |
wsdapi.h |
Library |
wsdapi.lib |