IWSDDeviceHost::RetireService 方法 (wsdhost.h)
注销使用 RegisterService 注册的服务对象,并从设备主机元数据中删除该服务。
语法
HRESULT RetireService(
[in] LPCWSTR pszServiceId
);
参数
[in] pszServiceId
要删除的服务的 ID。
返回值
可能的返回值包括但不限于以下值:
返回代码 | 说明 |
---|---|
|
方法已成功完成。 |
|
pszServiceId 为 NULL。 |
|
pszServiceId 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) ,或者在已注册服务列表中找不到 pszServiceId。 |
|
方法失败。 它可能已失败,因为主机尚未初始化。 调用 Init 以初始化设备主机。 |
注解
设备主机在取消注册服务后释放其对服务对象的引用。 完成 RetireService 后,服务对象将不会接收回调。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wsdhost.h (包括 Wsdapi.h) |
DLL | Wsdapi.dll |