InternetGetLastResponseInfoA-Funktion (wininet.h)
Ruft die letzte Fehlerbeschreibung oder Serverantwort für den Thread ab, der diese Funktion aufruft.
Syntax
BOOL InternetGetLastResponseInfoA(
[out] LPDWORD lpdwError,
[out] LPSTR lpszBuffer,
[in, out] LPDWORD lpdwBufferLength
);
Parameter
[out] lpdwError
Zeiger auf eine Variable, die eine Fehlermeldung bezüglich des fehlgeschlagenen Vorgangs empfängt.
[out] lpszBuffer
Zeiger auf einen Puffer, der den Fehlertext empfängt.
[in, out] lpdwBufferLength
Zeiger auf eine Variable, die die Größe des lpszBuffer-Puffers in TCHARs enthält. Wenn die Funktion zurückgibt, enthält dieser Parameter die Größe der Zeichenfolge, die in den Puffer geschrieben wurde, ohne die endende Null einzuschließt.
Rückgabewert
Gibt TRUE zurück, wenn Fehlertext erfolgreich in den Puffer geschrieben wurde, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Wenn der Puffer zu klein ist, um den gesamten Fehlertext aufzunehmen, gibt GetLastErrorERROR_INSUFFICIENT_BUFFER zurück, und der parameter lpdwBufferLength enthält die minimale Puffergröße, die erforderlich ist, um den gesamten Fehlertext zurückzugeben.
Hinweise
Die FTP-Protokolle können zusätzliche Textinformationen zusammen mit den meisten Fehlern zurückgeben. Diese erweiterten Fehlerinformationen können mithilfe der InternetGetLastResponseInfo-Funktion abgerufen werden, wenn GetLastErrorERROR_INTERNET_EXTENDED_ERROR zurückgibt (nach einem nicht erfolgreichen Funktionsaufruf).
Der Puffer, auf den von lpszBuffer verwiesen wird, muss groß genug sein, um sowohl die Fehlerzeichenfolge als auch ein Nullabschlusszeichen am Ende der Zeichenfolge zu enthalten. Beachten Sie jedoch, dass der in lpdwBufferLength zurückgegebene Wert die endende Null nicht enthält.
InternetGetLastResponseInfo kann mehrmals aufgerufen werden, bis eine andere Funktion in diesem Thread aufgerufen wird. Wenn eine andere Funktion aufgerufen wird, wird der interne Puffer gelöscht, in dem die letzten Antwortinformationen gespeichert werden.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.
Hinweis
Der wininet.h-Header definiert InternetGetLastResponseInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wininet.h |
| Bibliothek | Wininet.lib |
| DLL | Wininet.dll |