Fonction InternetGetLastResponseInfoA (wininet.h)

Article
08/27/2023

Récupère la dernière description d’erreur ou la dernière réponse du serveur sur le thread appelant cette fonction.

Syntaxe

BOOL InternetGetLastResponseInfoA(
  [out]     LPDWORD lpdwError,
  [out]     LPSTR   lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength
);

Paramètres

[out] lpdwError

Pointeur vers une variable qui reçoit un message d’erreur relatif à l’opération qui a échoué.

[out] lpszBuffer

Pointeur vers une mémoire tampon qui reçoit le texte d’erreur.

[in, out] lpdwBufferLength

Pointeur vers une variable qui contient la taille de la mémoire tampon lpszBuffer , dans les TCHAR. Lorsque la fonction retourne, ce paramètre contient la taille de la chaîne écrite dans la mémoire tampon, sans inclure le zéro de fin.

Valeur retournée

Retourne TRUE si le texte d’erreur a été correctement écrit dans la mémoire tampon, ou FALSE dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Si la mémoire tampon est trop petite pour contenir tout le texte d’erreur, GetLastError retourne ERROR_INSUFFICIENT_BUFFER et le paramètre lpdwBufferLength contient la taille de mémoire tampon minimale requise pour renvoyer tout le texte d’erreur.

Remarques

Les protocoles FTP peuvent retourner des informations de texte supplémentaires ainsi que la plupart des erreurs. Ces informations d’erreur étendues peuvent être récupérées à l’aide de la fonction InternetGetLastResponseInfo chaque fois que GetLastError retourne ERROR_INTERNET_EXTENDED_ERROR (se produisant après un appel de fonction infructueux).

La mémoire tampon pointée par lpszBuffer doit être suffisamment grande pour contenir à la fois la chaîne d’erreur et un terminateur zéro à la fin de la chaîne. Toutefois, notez que la valeur retournée dans lpdwBufferLength n’inclut pas le zéro de fin.

InternetGetLastResponseInfo peut être appelé plusieurs fois jusqu’à ce qu’une autre fonction soit appelée sur ce thread. Lorsqu’une autre fonction est appelée, la mémoire tampon interne qui stocke les dernières informations de réponse est effacée.

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 WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Notes

L’en-tête wininet.h définit InternetGetLastResponseInfo 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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

Fonctions courantes

Fonctions WinINet

Partager via