Share via

コールバック関数WS_CREATE_DECODER_CALLBACK (webservices.h)

  • [アーティクル]

デコーダー インスタンスの作成を処理します。

構文

WS_CREATE_DECODER_CALLBACK WsCreateDecoderCallback;

HRESULT WsCreateDecoderCallback(
  [in]           void *createContext,
  [in]           WS_READ_CALLBACK readCallback,
  [in]           void *readContext,
                 void **decoderContext,
  [in, optional] WS_ERROR *error
)
{...}

パラメーター

[in] createContext

チャネルの作成時に使用される WS_CHANNEL_DECODER で指定された createContext。

[in] readCallback

メッセージ データの読み取りに使用する関数。 このコールバックは、WS_DECODER_START_CALLBACK、WS_DECODER_DECODE_CALLBACK、およびWS_DECODER_END_CALLBACKコールバックへの応答でのみ使用する必要があります。

[in] readContext

指定されたWS_READ_CALLBACKに渡す必要がある読み取 りコンテキスト。

decoderContext

デコーダー インスタンスを返します。 この値は、すべてのデコーダー コールバックに渡されます。

[in, optional] error

関数が失敗した場合に追加のエラー情報を格納する場所を指定します。

戻り値

このコールバック関数は、これらの値のいずれかを返すことができます。

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

注釈

チャネルは、必要に応じてデコーダー インスタンスを作成します。 各デコーダー インスタンスは、シングルスレッド形式で呼び出されます。 ただし、単一のデコーダー インスタンスでは、チャネルがメッセージの処理に複数のデコーダー インスタンスを使用する可能性があるため、チャネルからのすべてのメッセージが表示されることを想定しないでください。

要件

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