HTTP_COOKED_URL-Struktur (http.h)

Die HTTP_COOKED_URL-Struktur enthält eine überprüfte, kanonische UTF-16-codierte URL-Anforderungszeichenfolge zusammen mit Zeigern darauf und Elementlängen. Dies ist die Zeichenfolge, die die HTTP-Server-API mit registrierten UrlPrefix-Zeichenfolgen abgleicht , um die Anforderung entsprechend weiterzuleiten.

Syntax

typedef struct _HTTP_COOKED_URL {
  USHORT FullUrlLength;
  USHORT HostLength;
  USHORT AbsPathLength;
  USHORT QueryStringLength;
  PCWSTR pFullUrl;
  PCWSTR pHost;
  PCWSTR pAbsPath;
  PCWSTR pQueryString;
} HTTP_COOKED_URL, *PHTTP_COOKED_URL;

Member

FullUrlLength

Größe der Daten in Bytes, auf die vom pFullUrl-Element verwiesen wird, ohne ein beendendes NULL-Zeichen.

HostLength

Größe der Daten, auf die das pHost-Element verweist, in Bytes.

AbsPathLength

Größe der Daten, auf die das pAbsPath-Element verweist, in Bytes.

QueryStringLength

Größe der Daten in Bytes, auf die vom pQueryString-Member verwiesen wird.

pFullUrl

Zeiger auf das Schemaelement am Anfang der URL (muss entweder "http://..." sein. oder "https://...").

pHost

Zeiger auf das erste Zeichen im Hostelement, unmittelbar nach den doppelten Schrägstrichen am Ende des Schemaelements.

pAbsPath

Zeiger auf den dritten Schrägstrich ("/") in der Zeichenfolge. In einer UrlPrefix-Zeichenfolge ist dies der Schrägstrich direkt vor dem relativeUri-Element.

pQueryString

Zeiger auf das erste Fragezeichen (?) in der Zeichenfolge oder NULL , wenn keins vorhanden ist.

Hinweise

Beispiel: pFullUrl ist "http://www.fabrikam.com/path1/path2/file.ext?n1=v1& n2=v2", dann pHost zeigt auf "www.fabrikam", pAbsPath auf "/path1/..." und pQueryString zeigt auf "?n1=v1...".

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	http.h

Weitere Informationen

STRUKTUREN DER HTTP-Server-API, Version 1.0

HTTP_REQUEST