HttpQueryInfoA-Funktion (wininet.h)
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).
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
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 |