> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HCMockAddMock

> HCMockAddMock

# HCMockAddMock

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

## 構文

```cpp theme={null}
HRESULT HCMockAddMock(  
         HCMockCallHandle call,  
         const char* method,  
         const char* url,  
         const uint8_t* requestBodyBytes,  
         uint32_t requestBodySize  
)  
```

### パラメーター

*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](/reference/live/httpclient/mock/mock_members)


## Related topics

- [HCMockClearMocks](/ja-jp/reference/live/httpclient/mock/functions/hcmockclearmocks.md)
- [HCMockCallCreate](/ja-jp/reference/live/httpclient/mock/functions/hcmockcallcreate.md)
- [HCMockRemoveMock](/ja-jp/reference/live/httpclient/mock/functions/hcmockremovemock.md)
- [HCMockSetMockMatchedCallback](/ja-jp/reference/live/httpclient/mock/functions/hcmocksetmockmatchedcallback.md)
- [HCMockCallCloseHandle](/ja-jp/reference/live/httpclient/mock/functions/hcmockcallclosehandle.md)