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 |