HTTP_COOKED_URL structure (http.h)

La structure HTTP_COOKED_URL contient une chaîne de requête d’URL encodée en unicode UTF-16 validée, canonique, ainsi que des pointeurs vers celle-ci et des longueurs d’éléments. Il s’agit de la chaîne que l’API du serveur HTTP met en correspondance avec les chaînes UrlPrefix inscrites afin d’acheminer la requête de manière appropriée.

Syntaxe

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;

Membres

FullUrlLength

Taille, en octets, des données pointées par le membre pFullUrl , sans un caractère null de fin.

HostLength

Taille, en octets, des données pointées par le membre pHost .

AbsPathLength

Taille, en octets, des données pointées par le membre pAbsPath .

QueryStringLength

Taille, en octets, des données pointées par le membre pQueryString .

pFullUrl

Pointeur vers l’élément de schéma au début de l’URL (doit être « http://... » ou « https://... »).

pHost

Pointeur vers le premier caractère de l’élément hôte, immédiatement après les barres obliques doubles à la fin de l’élément de schéma.

pAbsPath

Pointeur vers la troisième barre oblique (« / ») dans la chaîne. Dans une chaîne UrlPrefix, il s’agit de la barre oblique qui précède immédiatement l’élément relativeUri.

pQueryString

Pointeur vers le premier point d’interrogation ( ?) dans la chaîne, ou NULL s’il n’y en a pas.

Remarques

Par exemple, si pFullUrl a la valeur «http://www.fabrikam.com/path1/path2/file.ext?n1=v1& ; n2=v2 », puis pHost pointe vers « www.fabrikam », pAbsPath pointe vers « /path1/... » et pQueryString pointe vers « ?n1=v1... ».

Configuration requise

Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	http.h

Voir aussi

Structures de l’API serveur HTTP version 1.0

HTTP_REQUEST