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

Voir aussi

Structures de l’API serveur HTTP version 2.0

HTTP_RESPONSE_V1

HTTP_RESPONSE_V2

HttpSendHttpResponse

HttpSendResponseEntityBody