Skip to main content

HCMockAddMock

HCHttpCallPerformAsync() が呼び出されたときに、ネットワーク呼び出しを行う代わりにモック レスポンスを返すよう libHttpClient を構成します。

構文

パラメーター

call   _In_
型: HCMockCallHandle
HCMockResponseSet*() を使用して適切に構成されたモックを表す HC_MOCK_CALL_HANDLE。 method   _In_opt_z_
型: char*
特定の URL のみにモックを適用したい場合は、UTF-8 でエンコードされたメソッドと URL を渡します。 url   _In_opt_z_
型: char*
特定の URL のみにモックを適用したい場合は、UTF-8 でエンコードされたメソッドと URL を渡します。 requestBodyBytes   _In_reads_bytes_opt_(requestBodySize)
型: uint8_t*
特定の URL とリクエスト文字列のみにモックを適用したい場合は、メソッド、URL、および文字列の本文を渡します。 requestBodySize   _In_
型: uint32_t
requestBodyBytes のサイズ (バイト単位)。

戻り値

型: HRESULT この API 操作の結果コード。指定可能な値は、S_OK、E_INVALIDARG、E_OUTOFMEMORY、または E_FAIL です。

解説

モック レスポンスを定義するには、まず HCMockCallCreate() でモックを表す新しい HC_MOCK_CALL_HANDLE を作成します。次に HCMockResponseSet*() を使用してモック レスポンスを設定します。既定では、モック レスポンスはすべての HTTP 呼び出しに対して返されます。特定の URL のみにモックを適用したい場合は、URL を渡します。特定の URL とリクエスト本文のみにモックを適用したい場合は、URL と本文を渡します。HC_MOCK_CALL_HANDLE の構成が完了したら、HCMockAddMock() を呼び出してモックをシステムに追加します。HCMockAddMock() を複数回呼び出すことで、一連のモック レスポンスを複数アクティブに設定できます。HTTP 呼び出しが設定されたモック レスポンスに一致した場合、HCHttpCallPerformAsync() の後続の呼び出しごとに順番に実行されます。最後に一致するモック レスポンスに到達すると、その最後に一致するモック レスポンスが HCHttpCallPerformAsync() の後続の呼び出しごとに繰り返されます。

要件

ヘッダー: mock.h ライブラリ: libHttpClient.GDK.lib

関連項目

mock
最終更新日 2026年8月13日