共用方式為


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 傳遞至函式,函式會執行下列其他步驟:

規格需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll