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

Configure libHttpClient pour retourner une réponse fictive au lieu d'effectuer un appel réseau lorsque HCHttpCallPerformAsync() est appelée.

## Syntaxe

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

### Paramètres

*call*   \_In\_\
Type : HCMockCallHandle

HC\_MOCK\_CALL\_HANDLE représentant la simulation qui a été configurée en conséquence à l'aide de HCMockResponseSet\*()

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

Si vous souhaitez que la simulation s'applique uniquement à une URL spécifique, passez une méthode et une URL encodées en UTF-8.

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

Si vous souhaitez que la simulation s'applique uniquement à une URL spécifique, passez une méthode et une URL encodées en UTF-8.

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

Si vous souhaitez que la simulation s'applique uniquement à une URL et à une chaîne de requête spécifiques, passez une méthode, une URL et un corps de chaîne.

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

Taille de requestBodyBytes en octets.

### Valeur de retour

Type : HRESULT

Code de résultat de cette opération d'API. Les valeurs possibles sont S\_OK, E\_INVALIDARG, E\_OUTOFMEMORY ou E\_FAIL.

## Remarques

Pour définir une réponse fictive, créez un nouveau HC\_MOCK\_CALL\_HANDLE avec HCMockCallCreate() qui représente la simulation. Utilisez ensuite HCMockResponseSet\*() pour définir la réponse fictive. Par défaut, la réponse fictive est retournée pour tous les appels HTTP. Si vous souhaitez que la simulation s'applique uniquement à une URL spécifique, passez une URL. Si vous souhaitez que la simulation s'applique uniquement à une URL et à un corps de requête spécifiques, passez une URL et un corps. Une fois le HC\_MOCK\_CALL\_HANDLE configuré comme souhaité, ajoutez la simulation au système en appelant HCMockAddMock(). Vous pouvez définir plusieurs réponses fictives actives en appelant HCMockAddMock() plusieurs fois avec un ensemble de réponses fictives. Si l'appel HTTP correspond à un ensemble de réponses fictives, celles-ci sont exécutées dans l'ordre pour chaque appel suivant à HCHttpCallPerformAsync(). Lorsque la dernière réponse fictive correspondante est atteinte, elle est répétée à chaque appel suivant à HCHttpCallPerformAsync().

## Configuration requise

**En-tête :** mock.h

**Bibliothèque :** libHttpClient.GDK.lib

## Voir aussi

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


## Related topics

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