WsRequestReply 関数 (webservices.h)
要求メッセージを送信し、相関応答メッセージを受信するために使用されます。
構文
HRESULT WsRequestReply(
[in] WS_CHANNEL *channel,
[in] WS_MESSAGE *requestMessage,
[in] const WS_MESSAGE_DESCRIPTION *requestMessageDescription,
[in] WS_WRITE_OPTION writeOption,
const void *requestBodyValue,
[in] ULONG requestBodyValueSize,
[in] WS_MESSAGE *replyMessage,
[in] const WS_MESSAGE_DESCRIPTION *replyMessageDescription,
[in] WS_READ_OPTION readOption,
[in, optional] WS_HEAP *heap,
void *value,
[in] ULONG valueSize,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
パラメーター
[in] channel
要求/応答操作を実行するチャネル。
[in] requestMessage
要求の送信に使用するメッセージ オブジェクト。
メッセージ オブジェクトは 、WS_MESSAGE_STATE_EMPTY または WS_MESSAGE_STATE_INITIALIZED内にある必要があります。
[in] requestMessageDescription
WS_MESSAGE_DESCRIPTIONのアクション フィールドは、要求メッセージのアクション ヘッダーとして使用されます。 アクションが必要ない場合、このフィールドは NULL になる可能性があります。
WS_MESSAGE_DESCRIPTIONの bodyElementDescription フィールドは、要求メッセージの本文をシリアル化するために使用されます。 body 要素が必要ない場合、このフィールドは NULL になります。 bodyElementDescription に従って本文をシリアル化する方法については、「 WsWriteBody 」を参照してください。
[in] writeOption
body 要素が必要かどうか、および値の割り当て方法。 詳細については、「 WS_WRITE_OPTION 」を参照してください。
requestBodyValue
要求オブジェクトの本文でシリアル化する値へのポインター。
[in] requestBodyValueSize
シリアル化される要求値のサイズ (バイト単位)。
[in] replyMessage
応答の受信に使用するメッセージ オブジェクト。
メッセージ オブジェクトは 、WS_MESSAGE_STATE_EMPTYに存在する必要があります。
[in] replyMessageDescription
WS_MESSAGE_DESCRIPTIONのアクション フィールドは、受信した応答メッセージのアクション ヘッダーを確認するために使用されます。 アクションが必要ない場合、このフィールドは NULL になる可能性があります。 NULL の場合、受信したメッセージのアクション ヘッダーが存在する場合は無視されます。
WS_MESSAGE_DESCRIPTIONの bodyElementDescription フィールドは、応答メッセージの本文を逆シリアル化するために使用されます。 body 要素が必要ない場合、このフィールドは NULL になります。 bodyElementDescription に従って本文を逆シリアル化する方法については、「 WsReadBody 」を参照してください。
[in] readOption
応答本文要素が必要かどうか、および値を割り当てる方法。 詳細については、「 WS_READ_OPTION と WsReadBody」を参照してください。
[in, optional] heap
逆シリアル化された応答本文の値を割り当てるために使用されるヒープ。 指定した型にヒープが必要ない場合は、このパラメーターを NULL にすることができます。
value
本文の逆シリアル化された値を格納する場所。
このパラメーターの解釈は 、WS_READ_OPTIONによって異なります。
応答 WS_MESSAGE_DESCRIPTION の bodyElementDescription が NULL の場合、このパラメーターはタッチされません。 この場合、 パラメーターを指定する必要はありません。
[in] valueSize
このパラメーターの解釈は 、WS_READ_OPTIONによって異なります。
[in, optional] asyncContext
関数を非同期で呼び出す方法に関する情報。同期的に呼び出す場合は NULL 。
[in, optional] error
関数が失敗した場合に追加のエラー情報を格納する場所を指定します。
戻り値
この関数は、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
応答メッセージにエラーが含まれていました。 エラーは、WsGetErrorProperty を使用してWS_ERRORから抽出できます。 |
|
非同期操作はまだ保留中です。 |
|
操作が中止されました。 |
|
オブジェクトの現在の状態のため、操作は許可されません。 |
|
リモート エンドポイントが存在しないか、見つかりませんでした。 |
|
リモート エンドポイントによってアクセスが拒否されました。 |
|
リモート エンドポイントとの接続が終了しました。 |
|
リモート エンドポイントで要求を処理できませんでした。 |
|
リモート エンドポイントは現在、この場所でサービスを提供していません。 |
|
オーバーロードされているため、リモート エンドポイントで要求を処理できません。 |
|
リモート エンドポイントに到達できませんでした。 |
|
エンドポイント アドレス URL が無効です。 |
|
入力データが予期された形式でなかったか、予期された値を持っていませんでした。 |
|
割り当てられた時間内に操作が完了しませんでした。 |
|
HTTP プロキシ サーバーによってアクセスが拒否されました。 |
|
HTTP プロキシ サーバーが要求を処理できませんでした。 |
|
クォータを超えました。 |
|
受信したデータのセキュリティ検証が成功しなかった。 |
|
Windows Web Services フレームワークでセキュリティ操作が失敗しました。 |
|
セキュリティ トークンの有効期限が切れたため、サーバーによって拒否されました。 |
|
HTTP プロキシ サーバーには、HTTP 認証スキーム 'basic' が必要です。 |
|
HTTP プロキシ サーバーには、HTTP 認証スキーム 'digest' が必要です。 |
|
HTTP プロキシ サーバーには、HTTP 認証スキーム 'negotiate' が必要です。 |
|
HTTP プロキシ サーバーには、HTTP 認証スキーム 'NTLM' が必要です。 |
|
リモート エンドポイントには HTTP 認証スキーム 'basic' が必要です。 |
|
リモート エンドポイントには HTTP 認証スキーム 'digest' が必要です。 |
|
リモート エンドポイントには、HTTP 認証スキーム 'negotiate' が必要です。 |
|
リモート エンドポイントには HTTP 認証スキーム 'NTLM' が必要です。 |
|
署名されたファイル内の現在のシステム クロックまたはタイムスタンプに対して検証するときに、必要な証明書がその有効期間内にありません。 |
|
証明書の CN 名が、渡された値と一致しません。 |
|
証明書チェーンは処理されましたが、信頼プロバイダーによって信頼されていないルート証明書で終了しました。 |
|
証明書が要求された使用法に対して無効である。 |
|
失効サーバーがオフラインであったため、失効関数が失効を確認できませんでした。 |
|
メモリが不足しました。 |
|
1 つ以上の引数が無効です。 |
|
この関数は、上記以外のエラーを返す場合があります。 |
注釈
メッセージは、 WS_ADDRESSING_VERSIONに応じて関連付けされます。 要求応答メッセージの関連付けの詳細については、「 チャネル層の概要 」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | webservices.h |
| Library | WebServices.lib |
| [DLL] | WebServices.dll |