WS_SERVICE_MESSAGE_RECEIVE_CALLBACK

defaultMessageHandlerCallback が設定された WS_SERVICE_CONTRACT で構成されたエンドポイントで WS_MESSAGE を受信したときに呼び出されます。

受信した WS_MESSAGE、serviceProxy およびその他のパラメーターは、WS_OPERATION_CONTEXT を通じてコールバックから利用できます。

このコールバック関数は値を返しません。

定義されている場合、このコールバックはセッションベースのチャネル上でのすべての同時実行を禁止します。セッションベースのチャネルで同時実行が必要な場合は、アプリケーションは WS_SERVICE_CONTRACT に WS_SERVICE_MESSAGE_RECEIVE_CALLBACK を定義しないでください。

コールバックが呼び出される時点で、サービスモデルは受信側の WS_MESSAGE に対して WsReadMessageStart を実行済みです。本体 (body) を処理し、WsReadMessageEnd 操作を実行するのは、WS_SERVICE_MESSAGE_RECEIVE_CALLBACK を実装するアプリケーションの責任です。

コールバックが失敗した場合、基になるチャネルは中止されます。

関連項目: UnTypedServiceExample

例

WS_SERVICE_MESSAGE_RECEIVE_CALLBACK の定義

// Method contract for the service
static WS_SERVICE_CONTRACT calculatorContract = 
{
    NULL, 
    NULL, 
    DefaultMessageHandlerCallback, // WS_SERVICE_MESSAGE_RECEIVE_CALLBACK
    NULL
};

受信した WS_MESSAGE のプロパティへのアクセス

HRESULT CALLBACK MessageRecieved(const WS_OPERATION_CONTEXT* context, const WS_ASYNC_CONTEXT* asyncContext, WS_ERROR* error)
{
    :
    hr = WsGetOperationContextProperty(context, WS_OPERATION_CONTEXT_PROPERTY_INPUT_MESSAGE, &requestMessage, sizeof(requestMessage), NULL, error);
    :
}