webservices.h) (WS_ENDPOINT_ADDRESS 结构

  • 项目

表示终结点的网络地址。

语法

typedef struct _WS_ENDPOINT_ADDRESS {
  WS_STRING            url;
  WS_XML_BUFFER        *headers;
  WS_XML_BUFFER        *extensions;
  WS_ENDPOINT_IDENTITY *identity;
} WS_ENDPOINT_ADDRESS;

成员

url

地址的 URL 部分。

URL 始终采用转义形式。

如果此字符串的长度为零，则假定 URL 是匿名地址。 使用 WS_ENDPOINT_ADDRESS_TYPE 序列化或反序列化终结点地址时，匿名地址字符串会自动映射到零长度字符串或从 零长度字符串映射。

此字段的值对应于 WS-Addressing 规范的 Address 元素。

headers

一个WS_XML_BUFFER一组标头元素的句柄，这些元素表示终结点地址的引用参数。

需要标头才能与终结点正确交互。 它们用于进一步限定地址 (URL) 。

标头应被视为终结点地址用户的不透明值。

有关如何将标头添加到正在发送的消息的信息，请参阅 WsAddressMessage 。

如果没有标头，则此字段可能为 NULL 。

此字段的此值对应于 WS-Addressing 规范的 ReferenceParameters 元素的内容。

extensions

一组扩展元素 的WS_XML_BUFFER 句柄。 扩展元素用于在终结点地址中包含其他信息。 如果没有扩展元素，则此字段可能为 NULL 。

此字段的此值对应于 WS-Addressing 定义的其他元素和任何扩展元素。 元素必须按照规范以正确的顺序显示，后跟扩展元素。 此字段不应包含 Address 或 ReferenceParameters 或 Identity 的元素，因为这些值直接由此结构的其他字段表示。

如果 ReferenceProperties 元素 (WS_ADDRESSING_VERSION_0_9) 定义 ，则它必须是 WS_XML_BUFFER中的第一个元素。

identity

此终结点地址表示的终结点的安全标识。

此字段对应于 Identity 元素，该元素是基本 WS-Addressing 规范的扩展。

注解

只有 URL 字段是必需的， (其他字段可能为 NULL) 。

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
标头 webservices.h