WsAddressMessage 函式 (webservices.h)
語法
HRESULT WsAddressMessage(
[in] WS_MESSAGE *message,
[in, optional] const WS_ENDPOINT_ADDRESS *address,
[in, optional] WS_ERROR *error
);
參數
[in] message
表示要定址之訊息 的WS_MESSAGE 結構的指標。
[in, optional] address
WS_ENDPOINT_ADDRESS結構的指標，其中包含要定址訊息的端點。
注意 將 Null 傳遞至此參數表示訊息中不會新增任何標頭。 這提供將 WS_MESSAGE_PROPERTY_ID 設定為 WS_MESSAGE_PROPERTY_IS_ADDRESSED 的方法，而不需修改訊息中的標頭集。
[in, optional] error
如果函式失敗，WS_ERROR結構的指標，該結構會收到其他錯誤資訊。
傳回值
如果函式成功，它會傳回NO_ERROR;否則會傳回 HRESULT 錯誤碼。
| 傳回碼 | 描述 |
|---|---|
|
訊息已定址。 (WS_MESSAGE_PROPERTY_IS_ADDRESSED 屬性 會指出訊息是否已定址。) |
|
一或多個引數無效。 |
|
輸入資料不是預期的格式，或沒有預期的值。 |
|
記憶體不足，無法完成作業。 |
|
此函式可以傳回上面未列出的其他錯誤。 |
備註
如果您未藉由呼叫此函式來定址訊息，通道會自動定址傳遞至WsOpenChannel的端點位址訊息。
此函式會將 WS_MESSAGE_PROPERTY_IS_ADDRESSED 屬性設定為 TRUE，將訊息標示為已定址。
如果訊息已定址並傳回 WS_E_INVALID_OPERATION，則此函式會失敗。
如果將非NullWS_ENDPOINT_ADDRESS 傳遞至函式，函式會執行下列其他步驟：
- 標頭類型設定為 WS_TO_HEADER (請參閱WS_HEADER_TYPE列舉) ，而位址會設定為WS_ENDPOINT_ADDRESSurl 欄位的值。 如果 URL 長度為零，則會為訊息設定 匿名 URL 的WS_ADDRESSING_VERSION特定標記法。
- WS_ENDPOINT_ADDRESS標頭欄位中指定之WS_XML_BUFFER中的每個標頭都會新增至訊息。 如果緩衝區為 Null，則不會新增標頭。
規格需求
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | webservices.h |
| 程式庫 | WebServices.lib |
| Dll | WebServices.dll |