HttpQueryInfoA-Funktion (wininet.h)

Ruft Kopfzeileninformationen ab, die einer HTTP-Anforderung zugeordnet sind.

Syntax

BOOL HttpQueryInfoA(
  [in]      HINTERNET hRequest,
  [in]      DWORD     dwInfoLevel,
  [in, out] LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength,
  [in, out] LPDWORD   lpdwIndex
);

Parameter

[in] hRequest

Ein Handle, das von einem Aufruf der HttpOpenRequest- oder InternetOpenUrl- funktion zurückgegeben wird.

[in] dwInfoLevel

Eine Kombination aus einem abzurufenden Attribut und Flags, die die Anforderung ändern. Eine Liste der möglichen Attribut- und Modifiziererwerte finden Sie unter Abfrageinfo flags.

[in, out] lpBuffer

Ein Zeiger auf einen Puffer, um die angeforderten Informationen zu empfangen. Dieser Parameter darf nicht NULL-sein.

[in, out] lpdwBufferLength

Ein Zeiger auf eine Variable, die beim Eintrag die Größe in Byte des Puffers enthält, auf lpvBuffer-verweist.

Wenn die Funktion erfolgreich zurückgegeben wird, enthält diese Variable die Anzahl der Inte von Informationen, die in den Puffer geschrieben wurden. Bei einer Zeichenfolge enthält die Byteanzahl nicht das Beenden der Zeichenfolge NULL- Zeichen.

Wann die Funktion
schlägt mit einem erweiterten Fehlercode von ERROR_INSUFFICIENT_BUFFERfehl, die Variable, auf die durch lpdwBufferLength beim Beenden der Größe eines Puffers groß genug ist, um die angeforderten Informationen zu empfangen. Die aufrufende Anwendung kann dann einen Puffer dieser Größe oder größer zuordnen und die Funktion erneut aufrufen.

[in, out] lpdwIndex

Ein Zeiger auf einen nullbasierten Headerindex, der zum Aufzählen mehrerer Header mit demselben Namen verwendet wird. Beim Aufrufen der Funktion ist dieser Parameter der Index des angegebenen Headers, der zurückgegeben werden soll. Wenn die Funktion zurückgegeben wird, ist dieser Parameter der Index der nächsten Kopfzeile. Wenn der nächste Index nicht gefunden werden kann, wird ERROR_HTTP_HEADER_NOT_FOUND zurückgegeben.

Rückgabewert

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Sie können die folgenden Datentypen aus HttpQueryInfo-abrufen:

• Zeichenfolgen (Standard)
• SYSTEMTIME- (für Datumsangaben)
• DWORD- (für STATUS_CODE, CONTENT_LENGTHusw., wenn HTTP_QUERY_FLAG_NUMBER verwendet wurde)

Wenn Ihre Anwendung erfordert, dass die Daten als anderer Datentyp als Zeichenfolge zurückgegeben werden, müssen Sie den entsprechenden Modifizierer mit dem Attribut angeben, das an dwInfoLevelübergeben wird.

Die HttpQueryInfo--Funktion ist in Microsoft Internet Explorer 3.0 für ISO-8859-1-Zeichen (HttpQueryInfoA--Funktion) und in Internet Explorer 4 verfügbar. 0 oder höher für ISO-8859-1 Zeichen (HttpQueryInfoA Funktion) und für ISO-8859-1-Zeichen, die in UTF-16LE-Zeichen konvertiert werden. (die funktion HttpQueryInfoW).

Hinweis Die HttpQueryInfoA--Funktion stellt Kopfzeilen als ISO-8859-1-Zeichen und keine ANSI-Zeichen dar. Die HttpQueryInfoW--Funktion stellt Header als ISO-8859-1-Zeichen dar, die in UTF-16LE-Zeichen konvertiert werden. Daher ist es nie sicher, die HttpQueryInfoW--Funktion zu verwenden, wenn die Header nicht-ASCII-Zeichen enthalten können. Stattdessen kann eine Anwendung die funktionen MultiByteToWideChar und WideCharToMultiByte- verwenden, wobei ein Codepage- Parameter auf 28591 festgelegt ist, um zwischen ANSI-Zeichen und UTF-16LE-Zeichen zuzuordnen.

 

Ein Beispielcode, der die HttpQueryInfo-Funktion aufruft, finden Sie unter Abrufen von HTTP-Headern.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.

Hinweis WinINet keine Serverimplementierungen unterstützt. Darüber hinaus sollte sie nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder -dienste Microsoft Windows HTTP Services (WinHTTP).

 

Anmerkung

Der wininet.h-Header definiert HttpQueryInfo 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

Siehe auch

HTTP-Sitzungen

Abrufen von HTTP-Headern

WinINet-Funktionen