Edit

IWSDDeviceHost::RemoveDynamicService method (wsdhost.h)

  • Article

Unregisters a service object that was registered using AddDynamicService. An unregistered service object does not receive incoming requests.

Syntax

HRESULT RemoveDynamicService(
  [in] LPCWSTR pszServiceId
);

Parameters

[in] pszServiceId

The ID for the dynamic service to be removed.

Return value

Possible return values include, but are not limited to, the following:

Return code Description
S_OK
 Method completed successfully.
E_INVALIDARG
 pszServiceId is NULL, the length in characters of pszServiceId exceeds WSD_MAX_TEXT_LENGTH (8192), or pszServiceId was not found in the list of dynamic services.
E_FAIL
 The method failed. It may have failed because the host has not been initialized. Call 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 RemoveDynamicService has completed.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wsdhost.h (include Wsdapi.h)
DLL Wsdapi.dll

See also

IWSDDeviceHost