IWSDDeviceHost::RetireService (Windows Embedded CE 6.0)
1/6/2010
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 |
| Windows Embedded CE | Windows Embedded CE 6.0 R2 |