InternetGetLastResponseInfoW-Funktion (wininet.h)

Artikel
08/27/2023

Ruft die letzte Fehlerbeschreibung oder Serverantwort für den Thread ab, der diese Funktion aufruft.

Syntax

BOOL InternetGetLastResponseInfoW(
  [out]     LPDWORD lpdwError,
  [out]     LPWSTR  lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength
);

Parameter

[out] lpdwError

Zeiger auf eine Variable, die eine Fehlermeldung empfängt, die sich auf den fehlgeschlagenen Vorgang bezieht.

[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.

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 lpdwBufferLength-Parameter enthält die mindeste 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 lpszBuffer verweist, muss groß genug sein, um sowohl die Fehlerzeichenfolge als auch einen Zero-Abschluss am Ende der Zeichenfolge zu enthalten. Beachten Sie jedoch, dass der in lpdwBufferLength zurückgegebene Wert nicht die beendende Null 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, der die letzten Antwortinformationen speichert.

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 aus 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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