通过

IWSDiscoveryPublisher：：UnPublish 方法 (wsddisco.h)

  • 项目

通过发送 Bye 消息来宣布网络主机的离开。

语法

HRESULT UnPublish(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSDXML_ELEMENT *pAny
);

参数

[in] pszId

设备的逻辑或物理地址，用作设备终结点地址。 逻辑地址的格式 urn:uuid:{guid}为 。 物理地址可以是以 http 或 https 为前缀的 URI，也可以是前缀为 的 uriURI。 尽可能使用逻辑地址。

[in] ullInstanceId

要发布的设备的当前实例的标识符。 每当重新启动服务时，都必须递增此标识符。 有关实例标识符的详细信息，请参阅 WS-Discovery 规范的附录 I。

注意 为了与 WS-Discovery 规范兼容，此值必须小于或等于 UINT_MAX (4294967295) 。
 

[in] ullMessageNumber

当前消息的实例标识符范围内的计数器。 必须针对每条消息递增消息编号。

注意 为了与 WS-Discovery 规范兼容，此值必须小于或等于 UINT_MAX (4294967295) 。
 

[in, optional] pszSessionId

当前会话的实例标识符范围内的唯一标识符。 此参数对应于探测消息中 AppSequence 块中的序列标识符。 有关序列标识符的详细信息，请参阅 WS-Discovery 规范的附录 I。

此参数可以为 NULL。

[in, optional] pAny

指向 WSDXML_ELEMENT 结构的指针，该结构包含要插入到消息正文的“ANY”节中的 XML 元素。

返回值

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

返回代码 说明
S_OK
 该方法已成功完成。
E_INVALIDARG
 以下一个或多个条件为 true：
  • pszId 为 NULL。
  • pszId 的长度超过 WSD_MAX_TEXT_LENGTH (8192) 。
  • pszSessionId 的长度超过 WSD_MAX_TEXT_LENGTH (8192) 。
E_ABORT
 发布服务器尚未启动。 附加通知接收器将启动发布服务器。 若要附加接收器，请调用 RegisterNotificationSink。
E_OUTOFMEMORY
 内存不足，无法完成操作。

注解

如果成功， UnPublish 将使用提供的信息向本地子网发送 WS-Discovery Bye 消息。

要求

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

另请参阅

IWSDiscoveryPublisher