次の方法で共有

HCMockAddMock

  • [アーティクル]

HCHttpCallPerformAsync() が呼び出されたときにネットワーク呼び出しを行うのではなく、モック応答を返すように libHttpClient を構成します。

構文

HRESULT HCMockAddMock(  
         HCMockCallHandle call,  
         const char* method,  
         const char* url,  
         const uint8_t* requestBodyBytes,  
         uint32_t requestBodySize  
)

パラメーター

call _In_
型: HCMockCallHandle

この HC_MOCK_CALL_HANDLE は、HCMockResponseSet*() を使用して適切に構成されたモックを表します。

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() の後続の呼び出しごとに順番に実行されます。 最後に一致したモック応答がヒットすると、最後に一致したモック応答が hchtpCallperformAsync () の後続の呼び出しごとに繰り返されます。

要件

ヘッダー: mock.h

ライブラリ: libHttpClient.GDK.lib

関連項目

mock