structure HTTP_LOG_FIELDS_DATA (http.h)
La structure HTTP_LOG_FIELDS_DATA est utilisée pour passer les champs enregistrés pour une réponse HTTP lorsque la journalisation WC3 est activée.
Syntaxe
typedef struct _HTTP_LOG_FIELDS_DATA {
HTTP_LOG_DATA Base;
USHORT UserNameLength;
USHORT UriStemLength;
USHORT ClientIpLength;
USHORT ServerNameLength;
USHORT ServiceNameLength;
USHORT ServerIpLength;
USHORT MethodLength;
USHORT UriQueryLength;
USHORT HostLength;
USHORT UserAgentLength;
USHORT CookieLength;
USHORT ReferrerLength;
PWCHAR UserName;
PWCHAR UriStem;
PCHAR ClientIp;
PCHAR ServerName;
PCHAR ServiceName;
PCHAR ServerIp;
PCHAR Method;
PCHAR UriQuery;
PCHAR Host;
PCHAR UserAgent;
PCHAR Cookie;
PCHAR Referrer;
USHORT ServerPort;
USHORT ProtocolStatus;
ULONG Win32Status;
HTTP_VERB MethodNum;
USHORT SubStatus;
} HTTP_LOG_FIELDS_DATA, *PHTTP_LOG_FIELDS_DATA;
Membres
Base
Initialisez ce membre à la valeur HttpLogDataTypeFields de l’énumération HTTP_LOG_DATA_TYPE .
UserNameLength
Taille, en octets, du membre du nom d’utilisateur.
UriStemLength
Taille, en octets, du membre de la tige d’URI.
ClientIpLength
Taille, en octets, du membre d’adresse IP du client.
ServerNameLength
Taille, en octets, du membre du nom du serveur.
ServiceNameLength
ServerIpLength
Taille, en octets, du membre d’adresse IP du serveur.
MethodLength
Taille, en octets, du membre de la méthode HTTP.
UriQueryLength
Taille, en octets, du membre de requête URI.
HostLength
Taille, en octets, du membre du nom d’hôte.
UserAgentLength
Taille, en octets, du membre de l’agent utilisateur.
CookieLength
Taille, en octets, du membre de cookie.
ReferrerLength
Taille, en octets, du membre référent.
UserName
Nom de l'utilisateur.
UriStem
Tige URI.
ClientIp
Adresse IP du client.
ServerName
Le nom du serveur
ServiceName
Nom du service.
ServerIp
Adresse IP du serveur.
Method
Méthode HTTP.
UriQuery
Requête URI.
Host
Informations sur l’hôte de la demande.
UserAgent
Nom de l’agent d’utilisateur.
Cookie
Cookie fourni par l’application.
Referrer
Référent.
ServerPort
Port du serveur.
ProtocolStatus
Le protocole status.
Win32Status
Le win32 status.
MethodNum
Numéro de méthode.
SubStatus
Sous-status.
Remarques
La structure HTTP_LOG_FIELDS_DATA est un paramètre facultatif (pLogData) dans les fonctions HttpSendResponseEntityBody et HttpSendHttpResponse commençant par l’API HTTP version 2.0. La structure HTTP_LOG_FIELDS_DATA spécifie les champs enregistrés dans la réponse.
Sauf si cette structure est transmise, la réponse n’est pas journalisée, même lorsque la propriété de journalisation du serveur est définie sur un groupe d’URL ou une session serveur. Les demandes ne sont pas consignées, sauf si l’application passe la structure HTTP_LOG_FIELDS_DATA à chaque réponse et que la propriété de journalisation est définie sur la session serveur ou le groupe d’URL. La plupart des champs de la structure HTTP_LOG_FIELDS_DATA peuvent être initialisés à partir du champ correspondant dans la structure de HTTP_REQUEST . Toutefois, certains champs de journal ne sont connus que de l’application ; par exemple, Win32Status et SubStatus. Cette structure permet aux applications de modifier les champs enregistrés. L’application transmet un pointeur NULL et une longueur nulle au membre correspondant pour désactiver la journalisation pour ce champ.
Les applications doivent fournir la structure HTTP_LOG_FIELDS_DATA avec le dernier appel d’envoi. Si une réponse est envoyée avec un seul appel à HttpSendHttpResponse, les données de journal doivent être fournies dans cet appel. Si la réponse est envoyée sur plusieurs appels d’envoi, les données doivent être fournies avec le dernier appel à HttpSendResponseEntityBody.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | http.h |