InternetGetLastResponseInfoA, fonction (wininet.h)
Récupère la dernière description d’erreur ou la 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 ayant é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 TCHARs. Lorsque la fonction est retournée, ce paramètre contient la taille de la chaîne écrite dans la mémoire tampon, sans inclure la fin zéro.
Valeur de retour
Retourne TRUE si le texte d’erreur a été correctement écrit dans la mémoire tampon, ou FALSE sinon. Pour obtenir des informations d’erreur étendues, 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 minimale de la mémoire tampon 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
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 la valeur zéro de fin.
InternetGetLastResponseInfo peut être appelée plusieurs fois jusqu’à ce qu’une autre fonction soit appelée sur ce thread. Quand 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
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. 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 |