WsCreateMessage 函式 (webservices.h)

  • 發行項

使用指定的屬性建立 訊息 物件。

語法

HRESULT WsCreateMessage(
  [in]           WS_ENVELOPE_VERSION       envelopeVersion,
  [in]           WS_ADDRESSING_VERSION     addressingVersion,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

參數

[in] envelopeVersion

指定郵件信封版本的 WS_ENVELOPE_VERSION 列舉值。

[in] addressingVersion

WS_ADDRESSING_VERSION，指定訊息的尋址版本。

properties

訊息的選擇性屬性陣列。 請參閱 WS_MESSAGE_PROPERTY。

此參數的值可以是 NULL，在此情況下， propertyCount 參數必須是 0 (零) 。

[in] propertyCount

屬性陣列中的 屬性 數目。

message

成功時，會接收代表新訊息 之WS_MESSAGE 結構的位址的指標。

當您不再需要此結構時，您必須呼叫 WsFreeMessage 來釋放它。

[in, optional] error

如果函式失敗，WS_ERROR結構的指標，該結構會收到其他錯誤資訊。

傳回值

如果函式成功，它會傳回NO_ERROR;否則會傳回 HRESULT 錯誤碼。

傳回碼 Description
E_OUTOFMEMORY
 記憶體不足，無法完成作業。
E_INVALIDARG
 一或多個引數無效。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

備註

訊息對像是 Windows Web 服務的傳遞車輛。 單一訊息物件可用來傳送或接收循序訊息。 以這種方式重複使用訊息物件可能會減少記憶體配置。 當您不再需要訊息時，您必須呼叫 WsFreeMessage 來釋放記憶體。 (如需重複使用訊息對象的詳細資訊，請參閱 WsResetMessage .)

如果您要建立訊息以搭配特定通道使用，請使用 WsCreateMessageForChannel 函式，以確保通道的正確訊息版本。

規格需求

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