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