HttpQueryInfoA, fonction (wininet.h)
Récupère les informations d’en-tête associées à une requête HTTP.
Syntaxe
BOOL HttpQueryInfoA(
[in] HINTERNET hRequest,
[in] DWORD dwInfoLevel,
[in, out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferLength,
[in, out] LPDWORD lpdwIndex
);
Paramètres
[in] hRequest
Handle retourné par un appel à la fonction HttpOpenRequest ou Fonction InternetOpenUrl.
[in] dwInfoLevel
Combinaison d’un attribut à récupérer et d’indicateurs qui modifient la requête. Pour obtenir la liste des valeurs d’attribut et de modificateur possibles, consultez indicateurs d’informations de requête.
[in, out] lpBuffer
Pointeur vers une mémoire tampon pour recevoir les informations demandées. Ce paramètre ne doit pas être NULL.
[in, out] lpdwBufferLength
Pointeur vers une variable qui contient, lors de l’entrée, la taille en octets de la mémoire tampon pointée par lpvBuffer.
Lorsque la fonction retourne correctement, cette variable contient le nombre d’octets d’informations écrites dans la mémoire tampon. Dans le cas d’une chaîne, le nombre d’octets n’inclut pas la fin de la chaîne caractère null.
Quand la fonction
échoue avec un code d’erreur étendu de ERROR_INSUFFICIENT_BUFFER, la variable pointée par lpdwBufferLength contient la taille, en octets, d’une mémoire tampon suffisamment grande pour recevoir les informations demandées. L’application appelante peut ensuite allouer une mémoire tampon de cette taille ou plus grande, puis appeler à nouveau la fonction.
[in, out] lpdwIndex
Pointeur vers un index d’en-tête de base zéro utilisé pour énumérer plusieurs en-têtes portant le même nom. Lors de l’appel de la fonction, ce paramètre est l’index de l’en-tête spécifié à retourner. Lorsque la fonction est retournée, ce paramètre est l’index de l’en-tête suivant. Si l’index suivant est introuvable, ERROR_HTTP_HEADER_NOT_FOUND est retourné.
Valeur de retour
Retourne TRUE en cas de réussite ou FALSE sinon. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Vous pouvez récupérer les types de données suivants à partir de httpQueryInfo:
- Chaînes (valeur par défaut)
- SYSTEMTIME (pour les dates)
- DWORD (pour STATUS_CODE, CONTENT_LENGTH, et ainsi de suite, si HTTP_QUERY_FLAG_NUMBER a été utilisé)
Si votre application exige que les données soient retournées en tant que type de données autre qu’une chaîne, vous devez inclure le modificateur approprié avec l’attribut passé à dwInfoLevel.
La fonction
Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.
Note
L’en-tête wininet.h définit HttpQueryInfo comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | wininet.h |
| bibliothèque | Wininet.lib |
| DLL | Wininet.dll |