> ## 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 libHttpClient para que devuelva una respuesta ficticia en lugar de realizar una llamada de red cuando se llama a HCHttpCallPerformAsync().

## Sintaxis

```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 que representa la simulación que se ha configurado en consecuencia mediante HCMockResponseSet\*()

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

Si desea que la simulación solo se aplique a una dirección URL específica, pase un método y una dirección URL codificados en UTF-8.

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

Si desea que la simulación solo se aplique a una dirección URL específica, pase un método y una dirección URL codificados en UTF-8.

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

Si desea que la simulación solo se aplique a una dirección URL y una cadena de solicitud específicas, pase un método, una dirección URL y un cuerpo de cadena.

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

El tamaño de requestBodyBytes en bytes.

### Valor devuelto

Tipo: HRESULT

Código de resultado de esta operación de API. Los valores posibles son S\_OK, E\_INVALIDARG, E\_OUTOFMEMORY o E\_FAIL.

## Comentarios

Para definir una respuesta ficticia, cree un nuevo HC\_MOCK\_CALL\_HANDLE con HCMockCallCreate() que represente la simulación. A continuación, use HCMockResponseSet\*() para establecer la respuesta ficticia. De forma predeterminada, la respuesta ficticia se devolverá para todas las llamadas HTTP. Si desea que la simulación solo se aplique a una dirección URL específica, pase una dirección URL. Si desea que la simulación solo se aplique a una dirección URL y un cuerpo de solicitud específicos, pase una dirección URL y un cuerpo. Una vez que el HC\_MOCK\_CALL\_HANDLE esté configurado como desee, agregue la simulación al sistema llamando a HCMockAddMock(). Puede establecer varias respuestas ficticias activas llamando a HCMockAddMock() varias veces con un conjunto de respuestas ficticias. Si la llamada HTTP coincide con un conjunto de respuestas ficticias establecidas, se ejecutarán en orden para cada llamada posterior a HCHttpCallPerformAsync(). Cuando se alcanza la última respuesta ficticia coincidente, esta última respuesta ficticia coincidente se repetirá en cada llamada posterior a HCHttpCallPerformAsync().

## Requisitos

**Encabezado:** mock.h

**Biblioteca:** libHttpClient.GDK.lib

## Consulte también

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


## Related topics

- [HCMockClearMocks](/es/reference/live/httpclient/mock/functions/hcmockclearmocks.md)
- [HCMockCallCreate](/es/reference/live/httpclient/mock/functions/hcmockcallcreate.md)
- [HCMockRemoveMock](/es/reference/live/httpclient/mock/functions/hcmockremovemock.md)
- [HCMockSetMockMatchedCallback](/es/reference/live/httpclient/mock/functions/hcmocksetmockmatchedcallback.md)
- [HCMockCallDuplicateHandle](/es/reference/live/httpclient/mock/functions/hcmockcallduplicatehandle.md)