次の方法で共有

WsInitializeMessage 関数 (webservices.h)

  • [アーティクル]

この関数は、処理の準備としてメッセージのヘッダーを初期化します。 メッセージが初期化された後、アプリケーションはヘッダーを追加できます。 成功すると、メッセージは WS_MESSAGE_STATE_INITIALIZED 状態になります。 関数が失敗した場合、状態遷移は発生しません。

構文

HRESULT WsInitializeMessage(
  [in]           WS_MESSAGE                *message,
  [in]           WS_MESSAGE_INITIALIZATION initialization,
  [in, optional] WS_MESSAGE                *sourceMessage,
  [in, optional] WS_ERROR                  *error
);

パラメーター

[in] message

初期化する Message オブジェクトへのポインター。 Message は、WsCreateMessage または WsCreateMessageForChannel によって返される有効なWS_MESSAGE オブジェクト インスタンスである必要があり、NULL にすることはできません。

[in] initialization

メッセージの初期化を定義します。

メモ初期化値が WS_REPLY_MESSAGE または WS_FAULT_MESSAGE に設定されている場合、メッセージは自動的にアドレス指定されます。
 

[in, optional] sourceMessage

メッセージ パラメーターの初期化に使用される メッセージ オブジェクトへのポインター。 初期化パラメーターの値が WS_DUPLICATE_MESSAGE、WS_REPLY_MESSAGE、またはWS_FAULT_MESSAGEでない限り、この値は NULL にする必要があります。

[in, optional] error

関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
E_OUTOFMEMORY
 メモリが不足しました。
E_INVALIDARG
 1 つ以上の引数が無効です。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

メッセージの最初の送信者は、 WsSetHeader を使用してアクション ヘッダーをメッセージに追加する必要があります。

この API は、 メッセージに対して WsWriteEnvelopeStart または WsWriteMessageStart が呼び出される前に呼び出す必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー webservices.h
Library WebServices.lib
[DLL] WebServices.dll