InternetGetLastResponseInfoA-Funktion (wininet.h)
Ruft die letzte Fehlerbeschreibung oder Serverantwort im Thread ab, der diese Funktion aufruft.
Syntax
BOOL InternetGetLastResponseInfoA(
[out] LPDWORD lpdwError,
[out] LPSTR lpszBuffer,
[in, out] LPDWORD lpdwBufferLength
);
Parameter
[out] lpdwError
Zeigen Sie auf eine Variable, die eine Fehlermeldung im Zusammenhang mit dem fehlgeschlagenen Vorgang empfängt.
[out] lpszBuffer
Zeigen Sie auf einen Puffer, der den Fehlertext empfängt.
[in, out] lpdwBufferLength
Zeiger auf eine Variable, die die Größe des lpszBuffer Puffer enthält, in TCHARs. Wenn die Funktion zurückgegeben wird, enthält dieser Parameter die Größe der in den Puffer geschriebenen Zeichenfolge, nicht einschließlich der endenden Null.
Rückgabewert
Gibt TRUE zurück, wenn Fehlertext erfolgreich in den Puffer geschrieben wurde, oder FALSE andernfalls. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. Wenn der Puffer zu klein ist, um den gesamten Fehlertext zu halten, gibt GetLastErrorERROR_INSUFFICIENT_BUFFERzurück, und der lpdwBufferLength Parameter enthält die mindeste Puffergröße, die erforderlich ist, um den gesamten Fehlertext zurückzugeben.
Bemerkungen
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 (tritt nach einem nicht erfolgreichen Funktionsaufruf auf).
Der Puffer, auf den lpszBuffer verweist, muss groß genug sein, um sowohl die Fehlerzeichenfolge als auch einen Null-Terminator am Ende der Zeichenfolge zu enthalten. Beachten Sie jedoch, dass der in lpdwBufferLength zurückgegebene Wert nicht die endende 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, der die letzten Antwortinformationen speichert, gelöscht.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | wininet.h |
| Library | Wininet.lib |
| DLL- | Wininet.dll |