Skip to main content

​
HCMockAddMock

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

​
Syntaxe

​
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
Last modified on October 6, 2026