IWSDDeviceHost::RetireService 方法 (wsdhost.h)

注销使用 RegisterService 注册的服务对象,并从设备主机元数据中删除该服务。

语法

HRESULT RetireService(
  [in] LPCWSTR pszServiceId
);

参数

[in] pszServiceId

要删除的服务的 ID。

返回值

可能的返回值包括但不限于以下值:

返回代码 说明
S_OK
方法已成功完成。
E_POINTER
pszServiceIdNULL
E_INVALIDARG
pszServiceId 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) ,或者在已注册服务列表中找不到 pszServiceId
E_FAIL
方法失败。 它可能已失败,因为主机尚未初始化。 调用 Init 以初始化设备主机。

注解

设备主机在取消注册服务后释放其对服务对象的引用。 完成 RetireService 后,服务对象将不会接收回调。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wsdhost.h (包括 Wsdapi.h)
DLL Wsdapi.dll

另请参阅

IWSDDeviceHost