Anfrageinfo-Flags (Winhttp.h)

Diese Attribute und Modifizierer werden von WinHttpQueryHeaders verwendet.

Die Attributflags werden von WinHttpQueryHeaders verwendet, um anzugeben, welche Informationen abgerufen werden sollen. Die meisten Attributflags werden direkt einem bestimmten HTTP-Header zugeordnet. Es gibt auch einige spezielle Flags, z. B. WINHTTP_QUERY_RAW_HEADERS, die nicht mit einem bestimmten Header zusammenhängen.

WINHTTP_QUERY_ACCEPT

Ruft die zulässigen Medientypen für die Antwort ab.

WINHTTP_QUERY_ACCEPT_CHARSET

Ruft die zulässigen Zeichensätze für die Antwort ab.

WINHTTP_QUERY_ACCEPT_ENCODING

Ruft die zulässigen Inhaltscodierungswerte für die Antwort ab.

WINHTTP_QUERY_ACCEPT_LANGUAGE

Ruft die akzeptablen natürlichen Sprachen für die Antwort ab.

WINHTTP_QUERY_ACCEPT_RANGES

Ruft die Typen von Bereichsanforderungen ab, die für eine Ressource akzeptiert werden.

WINHTTP_QUERY_AGE

Ruft das Feld Age-Antwortheader ab, das die Schätzung des Absenders der Zeit seit der Generierung der Antwort auf dem Ursprungsserver enthält.

WINHTTP_QUERY_ALLOW

Empfängt die vom Server unterstützten HTTP-Verben .

WINHTTP_QUERY_AUTHENTICATION_INFO

Ruft den Authentication-Info-Header ab.

WINHTTP_QUERY_AUTHORIZATION

Ruft die Autorisierungsanmeldeinformationen ab, die für eine Anforderung verwendet werden.

WINHTTP_QUERY_CACHE_CONTROL

Ruft die Cachesteuerungsdirektiven ab.

WINHTTP_QUERY_CONNECTION

Ruft alle Optionen ab, die für eine bestimmte Verbindung angegeben sind und nicht von Proxys über weitere Verbindungen kommuniziert werden dürfen.

WINHTTP_QUERY_CONTENT_BASE

Ruft den Basis-URI (Uniform Resource Identifier) ab, um relative URLs innerhalb der Entität aufzulösen.

WINHTTP_QUERY_CONTENT_DESCRIPTION

Veraltet. Wird für die Kompatibilität von Legacyanwendungen beibehalten.

WINHTTP_QUERY_CONTENT_DISPOSITION

Veraltet. Wird für die Kompatibilität von Legacyanwendungen beibehalten.

WINHTTP_QUERY_CONTENT_ENCODING

Ruft zusätzliche Inhaltscodierung ab, die auf die gesamte Ressource angewendet wurde.

WINHTTP_QUERY_CONTENT_ID

Ruft die Inhaltsidentifikation ab.

WINHTTP_QUERY_CONTENT_LANGUAGE

Ruft die Sprache ab, in der der Inhalt geschrieben ist.

WINHTTP_QUERY_CONTENT_LENGTH

Ruft die Größe der Ressource in Bytes ab.

WINHTTP_QUERY_CONTENT_LOCATION

Ruft den Ressourcenspeicherort für die in der Nachricht eingeschlossene Entität ab.

WINHTTP_QUERY_CONTENT_MD5

Ruft einen MD5-Digest des Entitätstexts ab, um eine End-to-End-Nachrichtenintegritätsprüfung für den Entitätstext bereitzustellen. Weitere Informationen finden Sie unter RFC 1864.

WINHTTP_QUERY_CONTENT_RANGE

Ruft die Position im vollständigen Entitätstext ab, an dem der Teilkörper der Entität eingefügt werden soll, und die Gesamtgröße des vollständigen Entitätskörpers.

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

Ruft eine Codierungstransformation ab, die für einen Entitätstext gilt. Es kann bereits angewendet worden sein, muss möglicherweise angewendet werden oder kann optional anwendbar sein.

WINHTTP_QUERY_CONTENT_TYPE

Empfängt den Inhaltstyp der Ressource, z. B. Text oder HTML.

WINHTTP_QUERY_COOKIE

Ruft alle Cookies ab, die der Anforderung zugeordnet sind.

WINHTTP_QUERY_COST

Wird nicht unterstützt.

WINHTTP_QUERY_CUSTOM

Bewirkt , dass WinHttpQueryHeaders nach dem im pwszName-Parameter angegebenen Headernamen sucht und die Headerinformationen in lpBuffer speichert. Eine Anwendung kann WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT verwenden, um die maximale Zeit zu begrenzen, die diese Abfrage auf den Empfang aller Header wartet.

WINHTTP_QUERY_DATE

Empfängt das Datum und die Uhrzeit, an dem die Nachricht ursprünglich wurde.

WINHTTP_QUERY_DERIVED_FROM

Wird nicht unterstützt.

WINHTTP_QUERY_ETAG

Ruft das Entitätstag für die zugeordnete Entität ab.

WINHTTP_QUERY_EXPECT

Ruft den Expect-Header ab, der angibt, ob die Clientanwendung 100 Antworten erwarten soll.

WINHTTP_QUERY_EXPIRES

Empfängt das Datum und die Uhrzeit, nach denen die Ressource als veraltet gelten soll.

WINHTTP_QUERY_FORWARDED

Veraltet. Wird für die Kompatibilität von Legacyanwendungen beibehalten.

WINHTTP_QUERY_FROM

Ruft die E-Mail-Adresse des Benutzers ab, der den anfordernden Benutzer-Agent steuert, wenn der From-Header angegeben ist.

WINHTTP_QUERY_HOST

Ruft den Internethost und die Portnummer der angeforderten Ressource ab.

WINHTTP_QUERY_IF_MATCH

Ruft den Inhalt des felds If-Match Anforderungsheader ab.

WINHTTP_QUERY_IF_MODIFIED_SINCE

Ruft den Inhalt des If-Modified-Since-Headers ab.

WINHTTP_QUERY_IF_NONE_MATCH

Ruft den Inhalt des Felds If-None-Match request-header ab.

WINHTTP_QUERY_IF_RANGE

Ruft den Inhalt des felds If-Range Anforderungsheader ab. Mit diesem Header kann die Clientanwendung überprüfen, ob die Entität im Zusammenhang mit einer teilweisen Kopie der Entität im Cache der Clientanwendung nicht aktualisiert wurde. Wenn die Entität nicht aktualisiert wurde, senden Sie die Teile, die der Clientanwendung fehlen. Wenn die Entität aktualisiert wurde, senden Sie die gesamte aktualisierte Entität.

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

Ruft den Inhalt des Felds If-Unmodified-Since request-header ab.

WINHTTP_QUERY_LINK

Veraltet. Wird für die Kompatibilität von Legacyanwendungen beibehalten.

WINHTTP_QUERY_LAST_MODIFIED

Empfängt das Datum und die Uhrzeit der letzten Änderung der Ressource. Datum und Uhrzeit werden vom Server bestimmt.

WINHTTP_QUERY_LOCATION

Ruft den absoluten URI ab, der in einem Location-Antwortheader verwendet wird.

WINHTTP_QUERY_MAX

Gibt den Höchstwert eines WINHTTP_QUERY_*-Werts an. Kein Abfrageflag.

WINHTTP_QUERY_MAX_FORWARDS

Ruft die Anzahl von Proxys oder Gateways ab, die die Anforderung an den nächsten eingehenden Server weiterleiten können.

WINHTTP_QUERY_MESSAGE_ID

Wird nicht unterstützt.

WINHTTP_QUERY_MIME_VERSION

Empfängt die Version des MIME-Protokolls (Multipurpose Internet Mail Extensions), das zum Erstellen der Nachricht verwendet wurde.

WINHTTP_QUERY_ORIG_URI

Veraltet. Wird aus Gründen der Legacyanwendungskompatibilität verwaltet.

WINHTTP_QUERY_PRAGMA

Empfängt die implementierungsspezifischen Direktiven, die für jeden Empfänger entlang der Anforderungs-/Antwortkette gelten können.

WINHTTP_QUERY_PROXY_AUTHENTICATE

Ruft das vom Proxy zurückgegebene Authentifizierungsschema und den Bereich ab.

WINHTTP_QUERY_PROXY_AUTHORIZATION

Ruft den Header ab, der verwendet wird, um den Benutzer bei einem Proxy zu identifizieren, der eine Authentifizierung erfordert. Dieser Header kann nur abgerufen werden, bevor die Anforderung an den Server gesendet wird.

WINHTTP_QUERY_PROXY_CONNECTION

Ruft den Proxy-Connection-Header ab.

WINHTTP_QUERY_PROXY_SUPPORT

Ruft den Proxy-Support-Header ab.

WINHTTP_QUERY_PUBLIC

Empfängt HTTP-Verben, die auf diesem Server verfügbar sind.

WINHTTP_QUERY_RANGE

Ruft den Bytebereich einer Entität ab.

WINHTTP_QUERY_RAW_HEADERS

Empfängt alle vom Server zurückgegebenen Header. Jeder Header wird durch "\0" beendet. Ein zusätzliches "\0" beendet die Liste der Header.

WINHTTP_QUERY_RAW_HEADERS_CRLF

Empfängt alle vom Server zurückgegebenen Header. Jeder Header wird durch eine CR/LF-Sequenz (Carriage Return/Line Feed) getrennt.

WINHTTP_QUERY_REFERER

Empfängt den URI der Ressource, in der der angeforderte URI abgerufen wurde.

WINHTTP_QUERY_REFRESH

Veraltet. Wird aus Gründen der Legacyanwendungskompatibilität verwaltet.

WINHTTP_QUERY_REQUEST_METHOD

Empfängt das HTTP-Verb, das in der Anforderung verwendet wird, in der Regel GET oder POST.

WINHTTP_QUERY_RETRY_AFTER

Ruft die Zeitspanne ab, für die der Dienst voraussichtlich nicht verfügbar ist.

WINHTTP_QUERY_SERVER

Ruft Informationen zu der Software ab, die vom Ursprungsserver zur Verarbeitung der Anforderung verwendet wird.

WINHTTP_QUERY_SET_COOKIE

Empfängt den Wert des Für die Anforderung gesetzten Cookies.

WINHTTP_QUERY_STATUS_CODE

Empfängt den vom Server zurückgegebenen Statuscode. Eine Liste der möglichen Werte finden Sie unter HTTP-Statuscodes.

WINHTTP_QUERY_STATUS_TEXT

Empfängt zusätzlichen Text, der vom Server in der Antwortzeile zurückgegeben wird.

WINHTTP_QUERY_TITLE

Veraltet. Wird aus Gründen der Legacyanwendungskompatibilität verwaltet.

WINHTTP_QUERY_TRANSFER_ENCODING

Ruft den Transformationstyp ab, der auf den Nachrichtentext angewendet wurde, damit er sicher zwischen Absender und Empfänger übertragen werden kann.

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

Ruft den Unless-Modified-Since-Header ab.

WINHTTP_QUERY_UPGRADE

Ruft die zusätzlichen Kommunikationsprotokolle ab, die vom Server unterstützt werden.

WINHTTP_QUERY_URI

Empfängt einen Teil oder den gesamten URI, anhand dessen die Request-URI-Ressource identifiziert werden kann.

WINHTTP_QUERY_USER_AGENT

Ruft Informationen zum Benutzer-Agent ab, der die Anforderung gestellt hat.

WINHTTP_QUERY_VARY

Ruft den Header ab, der angibt, dass die Entität aus einer Reihe verfügbarer Darstellungen der Antwort ausgewählt wurde, indem die servergesteuerte Aushandlung verwendet wird.

WINHTTP_QUERY_VERSION

Ruft die HTTP-Version ab, die in der Statuszeile vorhanden ist.

WINHTTP_QUERY_VIA

Ruft die Zwischenprotokolle und Empfänger zwischen dem Benutzer-Agent und dem Server für Anforderungen sowie zwischen dem Ursprungsserver und dem Client für Antworten ab.

WINHTTP_QUERY_WARNING

Ruft zusätzliche Informationen zum Status einer Antwort ab, die möglicherweise nicht vom Antwortstatuscode widerzuspiegeln sind.

WINHTTP_QUERY_WWW_AUTHENTICATE

Ruft das vom Server zurückgegebene Authentifizierungsschema und den Bereich ab.

Die Modifiziererflags werden in Verbindung mit einem Attributflag verwendet, um die Anforderung zu ändern. Modifiziererflags ändern entweder das Format der zurückgegebenen Daten oder geben an, wo die WinHttpQueryHeaders-Funktion nach den Informationen suchen soll.

WINHTTP_QUERY_FLAG_NUMBER

Gibt die Daten als 32-Bit-Zahl für Header zurück, deren Wert eine Zahl ist, z. B. der Statuscode.

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

Abfragen nur Anforderungsheader.

WINHTTP_QUERY_FLAG_SYSTEMTIME

Gibt den Headerwert als SYSTEMTIME-Struktur zurück, bei der die Anwendung die Daten nicht analysiert. Verwenden Sie für Header, deren Wert eine Datums-/Uhrzeitzeichenfolge ist, z. B. "Last-Modified-Time".

WINHTTP_QUERY_FLAG_TRAILERS

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Anforderungen

Siehe auch

• WinHTTP-Versionen