> ## 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

Configura a libHttpClient para retornar uma resposta simulada em vez de fazer uma chamada de rede quando HCHttpCallPerformAsync() é chamada.

## Sintaxe

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

### Parâmetros

*call*   \_In\_\
Tipo: HCMockCallHandle

Este HC\_MOCK\_CALL\_HANDLE representa a simulação que foi configurada adequadamente usando HCMockResponseSet\*()

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

Se você quiser que a simulação se aplique somente a uma URL específica, passe um método e uma URL codificados em UTF-8.

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

Se você quiser que a simulação se aplique somente a uma URL específica, passe um método e uma URL codificados em UTF-8.

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

Se você quiser que a simulação se aplique somente a uma URL e cadeia de caracteres de solicitação específicas, passe um método, uma URL e um corpo de cadeia de caracteres.

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

O tamanho de requestBodyBytes em bytes.

### Valor retornado

Tipo: HRESULT

Código de resultado desta operação de API. Os valores possíveis são S\_OK, E\_INVALIDARG, E\_OUTOFMEMORY ou E\_FAIL.

## Comentários

Para definir uma resposta simulada, crie um novo HC\_MOCK\_CALL\_HANDLE com HCMockCallCreate() que represente a simulação. Em seguida, use HCMockResponseSet\*() para definir a resposta simulada. Por padrão, a resposta simulada será retornada para todas as chamadas HTTP. Se você quiser que a simulação se aplique somente a uma URL específica, passe uma URL. Se você quiser que a simulação se aplique somente a uma URL e um corpo de solicitação específicos, passe uma URL e um corpo. Depois que o HC\_MOCK\_CALL\_HANDLE estiver configurado conforme desejado, adicione a simulação ao sistema chamando HCMockAddMock(). Você pode definir várias respostas simuladas ativas chamando HCMockAddMock() várias vezes com um conjunto de respostas simuladas. Se a chamada HTTP corresponder a um conjunto de respostas simuladas, elas serão executadas em ordem para cada chamada subsequente a HCHttpCallPerformAsync(). Quando a última resposta simulada correspondente for atingida, ela será repetida em cada chamada subsequente a HCHttpCallPerformAsync().

## Requisitos

**Cabeçalho:** mock.h

**Biblioteca:** libHttpClient.GDK.lib

## Confira também

[mock](/pt-BR/reference/live/httpclient/mock/mock_members)


## Related topics

- [HCMockClearMocks](/pt-BR/reference/live/httpclient/mock/functions/hcmockclearmocks.md)
- [HCMockCallCreate](/pt-BR/reference/live/httpclient/mock/functions/hcmockcallcreate.md)
- [HCMockRemoveMock](/pt-BR/reference/live/httpclient/mock/functions/hcmockremovemock.md)
- [HCMockSetMockMatchedCallback](/pt-BR/reference/live/httpclient/mock/functions/hcmocksetmockmatchedcallback.md)
- [HCMockResponseSetHeader](/pt-BR/reference/live/httpclient/mock/functions/hcmockresponsesetheader.md)