HttpQueryInfoA-Funktion (wininet.h)

  • Artikel

Ruft Headerinformationen 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 Abfrageinformationsflags.

[in, out] lpBuffer

Ein Zeiger auf einen Puffer zum Empfangen der angeforderten Informationen. Dieser Parameter darf nicht NULL sein.

[in, out] lpdwBufferLength

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

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

Wenn die Funktion
schlägt mit einem erweiterten Fehlercode von ERROR_INSUFFICIENT_BUFFER fehl. Die Variable, auf die von lpdwBufferLength verwiesen wird, enthält beim Beenden die Größe eines Puffers in Bytes, der 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 Auflisten 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ückgibt, ist dieser Parameter der Index des nächsten Headers. Wenn der nächste Index nicht gefunden werden kann, wird ERROR_HTTP_HEADER_NOT_FOUND zurückgegeben.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Sie können die folgenden Datentypen aus HttpQueryInfo abrufen:

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

Wenn Ihre Anwendung erfordert, dass die Daten als anderer Datentyp als eine Zeichenfolge zurückgegeben werden, müssen Sie den entsprechenden Modifizierer mit dem an dwInfoLevel übergebenen Attribut einschließen.

Die HttpQueryInfo-Funktion ist in Microsoft Internet Explorer 3.0 für ISO-8859-1-Zeichen (HttpQueryInfoA-Funktion) und im Internet Explorer 4.0 oder höher für ISO-8859-1-Zeichen (HttpQueryInfoA-Funktion) und für IN UTF-16LE-Zeichen konvertierte ISO-8859-1-Zeichen verfügbar. die HttpQueryInfoW-Funktion).

Hinweis Die HttpQueryInfoA-Funktion stellt Header als ISO-8859-1-Zeichen dar, nicht als ANSI-Zeichen. 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 mit einem Codepage-Parameter verwenden, der auf 28591 festgelegt ist, um ZWISCHEN ANSI-Zeichen und UTF-16LE-Zeichen zuzuordnen.
 
Unter Abrufen von HTTP-Headern finden Sie einen Beispielcode, der die HttpQueryInfo-Funktion aufruft.

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

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

HTTP-Sitzungen

Abrufen von HTTP-Headern

WinINet-Funktionen