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_E_INVALID_OPERATION	訊息已定址。 (WS_MESSAGE_PROPERTY_IS_ADDRESSED 屬性 會指出訊息是否已定址。)
E_INVALIDARG	一或多個引數無效。
WS_E_INVALID_FORMAT	輸入資料不是預期的格式，或沒有預期的值。
E_OUTOFMEMORY	記憶體不足，無法完成作業。
其他錯誤	此函式可以傳回上面未列出的其他錯誤。

備註

如果您未藉由呼叫此函式來定址訊息，通道會自動定址傳遞至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