通过

IWSDiscoveryPublisher：:P ublish 方法 (wsddisco.h)

  • 项目

通过发送 Hello 消息来宣布网络主机的状态。

语法

HRESULT Publish(
  [in]           LPCWSTR             pszId,
  [in]           ULONGLONG           ullMetadataVersion,
  [in]           ULONGLONG           ullInstanceId,
  [in]           ULONGLONG           ullMessageNumber,
  [in, optional] LPCWSTR             pszSessionId,
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] const WSD_URI_LIST  *pXAddrsList
);

参数

[in] pszId

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

[in] ullMetadataVersion

当前元数据版本。

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

[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] pTypesList

指向 WSD_NAME_LIST 结构的指针，该结构表示发布主机支持的类型列表。 可能为 NULL。

[in, optional] pScopesList

指向 WSD_URI_LIST 结构的指针，该结构表示发布主机支持的匹配范围的列表。 列表包含字符串形式的哈希值。 可能为 NULL。

[in, optional] pXAddrsList

指向表示发布主机支持的传输地址列表 的WSD_URI_LIST 结构的指针。 每个传输地址字符串都包含可用于远程主机连接的地址和端口号。 可能为 NULL。

返回值

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

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

注解

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

要求

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

另请参阅

IWSDiscoveryPublisher