Abfrageinfoflags (Wininet.h)

Die folgenden Listen enthalten die Attribute und Modifizierer, die von HttpQueryInfo und QueryInfo verwendet werden.

Die Attributflags werden von HttpQueryInfo (oder QueryInfo) verwendet, um anzugeben, welche Daten abgerufen werden sollen. Die meisten Attributflags werden direkt einem bestimmten HTTP-Header zugeordnet. Es gibt auch einige spezielle Flags, z. B. HTTP_QUERY_RAW_HEADERS, die nicht mit einem bestimmten Header zusammenhängen.

HTTP_QUERY_ACCEPT

24

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

HTTP_QUERY_ACCEPT_CHARSET

25

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

HTTP_QUERY_ACCEPT_ENCODING

26

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

HTTP_QUERY_ACCEPT_LANGUAGE

27

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

HTTP_QUERY_ACCEPT_RANGES

42

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

HTTP_QUERY_AGE

48

Ruft das Feld Age-Antwortheader ab, das die Schätzung des Absenders für die Zeitspanne enthält, seit die Antwort auf dem Ursprungsserver generiert wurde.

HTTP_QUERY_ALLOW

7

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

HTTP_QUERY_AUTHORIZATION

28

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

HTTP_QUERY_CACHE_CONTROL

49

Ruft die Cachesteuerungsdirektiven ab.

HTTP_QUERY_CONNECTION

23

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

HTTP_QUERY_CONTENT_BASE

50

Ruft den Basis-URI (Uniform Resource Identifier) zum Auflösen relativer URLs innerhalb der Entität ab.

HTTP_QUERY_CONTENT_DESCRIPTION

4

Veraltet. Wird nur für legacy-Anwendungskompatibilität beibehalten.

HTTP_QUERY_CONTENT_DISPOSITION

47

Veraltet. Wird nur für legacy-Anwendungskompatibilität beibehalten.

HTTP_QUERY_CONTENT_ENCODING

29

Ruft alle zusätzlichen Inhaltscodierungen ab, die auf die gesamte Ressource angewendet wurden.

HTTP_QUERY_CONTENT_ID

3

Ruft die Inhaltsidentifikation ab.

HTTP_QUERY_CONTENT_LANGUAGE

6

Ruft die Sprache ab, in der sich der Inhalt befindet.

HTTP_QUERY_CONTENT_LENGTH

5

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

HTTP_QUERY_CONTENT_LOCATION

51

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

HTTP_QUERY_CONTENT_MD5

52

Ruft einen MD5-Digest des Entitätskörpers ab, um eine End-to-End-Message Integrity Check (MIC) für den Entitätstext bereitzustellen. Weitere Informationen finden Sie unter RFC1864, The Content-MD5 Header Field, at https://ftp.isi.edu/in-notes/rfc1864.txt.

HTTP_QUERY_CONTENT_RANGE

53

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

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

Empfängt die zusätzliche Inhaltscodierung, die auf die Ressource angewendet wurde.

HTTP_QUERY_CONTENT_TYPE

1

Empfängt den Inhaltstyp der Ressource (z. B. text/html).

HTTP_QUERY_COOKIE

44

Ruft alle Cookies ab, die der Anforderung zugeordnet sind.

HTTP_QUERY_COST

15

Wird nicht mehr unterstützt.

HTTP_QUERY_CUSTOM

65.535

Bewirkt , dass HttpQueryInfo nach dem in lpvBuffer angegebenen Headernamen sucht und die Headerdaten in lpvBuffer speichert.

HTTP_QUERY_DATE

9

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

HTTP_QUERY_DERIVED_FROM

14

Wird nicht mehr unterstützt.

HTTP_QUERY_ECHO_HEADERS

73

Derzeit nicht implementiert.

HTTP_QUERY_ECHO_HEADERS_CRLF

74

Derzeit nicht implementiert.

HTTP_QUERY_ECHO_REPLY

72

Derzeit nicht implementiert.

HTTP_QUERY_ECHO_REQUEST

71

Derzeit nicht implementiert.

HTTP_QUERY_ETAG

54

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

HTTP_QUERY_EXPECT

68

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

HTTP_QUERY_EXPIRES

10

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

HTTP_QUERY_FORWARDED

30

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

HTTP_QUERY_FROM

31

Ruft die E-Mail-Adresse für den menschlichen Benutzer ab, der den anfordernden Benutzer-Agent steuert, wenn der From-Header angegeben wird.

HTTP_QUERY_HOST

55

Ruft den Internethost und die Portnummer der angeforderten Ressource ab.

HTTP_QUERY_IF_MATCH

56

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

HTTP_QUERY_IF_MODIFIED_SINCE

32

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

HTTP_QUERY_IF_NONE_MATCH

57

Ruft den Inhalt des Anforderungsheaderfelds If-None-Match ab.

HTTP_QUERY_IF_RANGE

58

Ruft den Inhalt des If-Range Felds request-header ab. Mit diesem Header kann die Clientanwendung überprüfen, ob die Entität, die sich auf eine Teilkopie der Entität im Clientanwendungscache bezieht, nicht aktualisiert wurde. Wenn die Entität nicht aktualisiert wurde, senden Sie die Teile, die in der Clientanwendung fehlen. Wenn die Entität aktualisiert wurde, senden Sie die gesamte aktualisierte Entität.

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

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

HTTP_QUERY_LAST_MODIFIED

11

Empfängt das Datum und die Uhrzeit, zu denen der Server glaubt, dass die Ressource zuletzt geändert wurde.

HTTP_QUERY_LINK

16

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

HTTP_QUERY_LOCATION

33

Ruft den absoluten URI (Uniform Resource Identifier) ab, der in einem Location-Antwortheader verwendet wird.

HTTP_QUERY_MAX

78

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

HTTP_QUERY_MAX_FORWARDS

60

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

HTTP_QUERY_MESSAGE_ID

12

Wird nicht mehr unterstützt.

HTTP_QUERY_MIME_VERSION

0

Empfängt die Version des MIME-Protokolls, das zum Erstellen der Nachricht verwendet wurde.

HTTP_QUERY_ORIG_URI

34

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

HTTP_QUERY_PRAGMA

17

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

HTTP_QUERY_PROXY_AUTHENTICATE

41

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

HTTP_QUERY_PROXY_AUTHORIZATION

61

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.

HTTP_QUERY_PROXY_CONNECTION

69

Ruft den Proxy-Connection-Header ab.

HTTP_QUERY_PUBLIC

8

Empfängt Methoden, die auf diesem Server verfügbar sind.

HTTP_QUERY_RANGE

62

Ruft den Bytebereich einer Entität ab.

HTTP_QUERY_RAW_HEADERS

21

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

HTTP_QUERY_RAW_HEADERS_CRLF

22

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

HTTP_QUERY_REFERER

35

Empfängt den URI (Uniform Resource Identifier) der Ressource, in der der angeforderte URI abgerufen wurde.

HTTP_QUERY_REFRESH

46

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

HTTP_QUERY_REQUEST_METHOD

45

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

HTTP_QUERY_RETRY_AFTER

36

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

HTTP_QUERY_SERVER

37

Ruft Daten über die Software ab, die vom Ursprungsserver zur Verarbeitung der Anforderung verwendet wird.

HTTP_QUERY_SET_COOKIE

43

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

HTTP_QUERY_STATUS_CODE

19

Empfängt den vom Server zurückgegebenen status Code. Weitere Informationen und eine Liste der möglichen Werte finden Sie unter HTTP-Statuscodes.

HTTP_QUERY_STATUS_TEXT

20

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

HTTP_QUERY_TITLE

38

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

HTTP_QUERY_TRANSFER_ENCODING

63

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

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

Ruft den Unless-Modified-Since-Header ab.

HTTP_QUERY_UPGRADE

64

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

HTTP_QUERY_URI

13

Empfängt einige oder alle URIs (Uniform Resource Identifiers), anhand derer die Request-URI-Ressource identifiziert werden kann.

HTTP_QUERY_USER_AGENT

39

Ruft Daten über den Benutzer-Agent ab, der die Anforderung gestellt hat.

HTTP_QUERY_VARY

65

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.

HTTP_QUERY_VERSION

18

Empfängt den letzten Antwortcode, der vom Server zurückgegeben wurde.

HTTP_QUERY_VIA

66

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.

HTTP_QUERY_WARNING

67

Ruft zusätzliche Daten zum status einer Antwort ab, die möglicherweise nicht in der Antwort status Code widerzuspiegeln sind.

HTTP_QUERY_WWW_AUTHENTICATE

40

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

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

Ruft den X-Content-Type-Options-Headerwert ab.

HTTP_QUERY_P3P

80

Ruft den P3P-Headerwert ab.

HTTP_QUERY_X_P2P_PEERDIST

81

Ruft den X-P2P-PeerDist-Headerwert ab.

HTTP_QUERY_TRANSLATE

82

Ruft den Translate-Headerwert ab.

HTTP_QUERY_X_UA_COMPATIBLE

83

Ruft den X-UA-Kompatiblen Headerwert ab.

HTTP_QUERY_DEFAULT_STYLE

84

Ruft den Default-Style-Headerwert ab.

HTTP_QUERY_X_FRAME_OPTIONS

85

Ruft den X-Frame-Options-Headerwert ab.

HTTP_QUERY_X_XSS_PROTECTION

86

Ruft den X-XSS-Protection-Headerwert 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 HttpQueryInfo (oder QueryInfo) nach den Daten suchen soll.

HTTP_QUERY_FLAG_COALESCE

0x10000000

Nicht implementiert.

HTTP_QUERY_FLAG_NUMBER

0x20000000

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

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

Abfragen nur Anforderungsheader.

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

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

Hinweise

Hinweis

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Wininet.h