> ## 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()가 호출될 때 네트워크 호출을 수행하는 대신 mock 응답을 반환하도록 libHttpClient를 구성합니다.

## Syntax

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

### Parameters

*call*   \_In\_\
Type: HCMockCallHandle

HCMockResponseSet\*()을 사용하여 적절히 구성된 mock을 나타내는 이 HC\_MOCK\_CALL\_HANDLE입니다.

*method*   \_In\_opt\_z\_\
Type: char\*

mock을 특정 URL에만 적용하려면 UTF-8로 인코딩된 메서드와 URL을 전달합니다.

*url*   \_In\_opt\_z\_\
Type: char\*

mock을 특정 URL에만 적용하려면 UTF-8로 인코딩된 메서드와 URL을 전달합니다.

*requestBodyBytes*   \_In\_reads\_bytes\_opt\_(requestBodySize)\
Type: uint8\_t\*

mock을 특정 URL 및 요청 문자열에만 적용하려면 메서드, URL 및 문자열 본문을 전달합니다.

*requestBodySize*   \_In\_\
Type: uint32\_t

requestBodyBytes의 크기(바이트)입니다.

### Return value

Type: HRESULT

이 API 작업의 결과 코드입니다. 가능한 값은 S\_OK, E\_INVALIDARG, E\_OUTOFMEMORY 또는 E\_FAIL입니다.

## Remarks

mock 응답을 정의하려면 mock을 나타내는 새 HC\_MOCK\_CALL\_HANDLE을 HCMockCallCreate()로 만듭니다. 그런 다음 HCMockResponseSet\*()을 사용하여 mock 응답을 설정합니다. 기본적으로 mock 응답은 모든 HTTP 호출에 대해 반환됩니다. mock을 특정 URL에만 적용하려면 URL을 전달합니다. mock을 특정 URL 및 요청 본문에만 적용하려면 URL과 본문을 전달합니다. HC\_MOCK\_CALL\_HANDLE이 원하는 대로 구성되면 HCMockAddMock()을 호출하여 시스템에 mock을 추가합니다. HCMockAddMock()을 mock 응답 세트로 여러 번 호출하여 여러 개의 활성 mock 응답을 설정할 수 있습니다. HTTP 호출이 설정된 mock 응답 세트와 일치하면 HCHttpCallPerformAsync()에 대한 각 후속 호출에 대해 순서대로 실행됩니다. 마지막 일치하는 mock 응답에 도달하면 이후 HCHttpCallPerformAsync() 호출마다 마지막 일치하는 mock 응답이 반복됩니다.

## Requirements

**Header:** mock.h

**Library:** libHttpClient.GDK.lib

## See also

[mock](/reference/live/httpclient/mock/mock_members)


## Related topics

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