WS_ENDPOINT_ADDRESS结构 (webservices.h)

表示终结点的网络地址。

语法

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