InternetGetLastResponseInfoA-Funktion (wininet.h)

Artikel
08/27/2023

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 GetLastError ERROR_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 WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

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

Weitere Informationen

Allgemeine Funktionen

WinINet-Funktionen

Share via