HTTP_LOG_FIELDS_DATA struttura (http.h)

Articolo
08/24/2023

La struttura HTTP_LOG_FIELDS_DATA viene usata per passare i campi registrati per una risposta HTTP quando è abilitata la registrazione WC3.

Sintassi

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;

Members

Base

Inizializzare questo membro nel valore HttpLogDataTypeFields dell'enumerazione HTTP_LOG_DATA_TYPE .

UserNameLength

Dimensioni, in byte, del membro nome utente.

UriStemLength

Dimensioni, in byte, del membro stem dell'URI.

ClientIpLength

Dimensioni, in byte, del membro dell'indirizzo IP client.

ServerNameLength

Dimensioni, in byte, del membro del nome del server.

ServiceNameLength

ServerIpLength

Dimensioni, in byte, del membro dell'indirizzo IP del server.

MethodLength

Dimensioni, in byte, del membro del metodo HTTP.

UriQueryLength

Dimensioni, in byte, del membro della query URI.

HostLength

Dimensioni, in byte, del membro del nome host.

UserAgentLength

Dimensioni, in byte, del membro dell'agente utente.

CookieLength

Dimensioni, in byte, del membro del cookie.

ReferrerLength

Dimensioni, in byte, del membro referrer.

UserName

Nome dell'utente.

UriStem

URI stem.

ClientIp

Indirizzo IP del client.

ServerName

Nome del server.

ServiceName

Il nome del servizio.

ServerIp

Indirizzo IP del server.

Method

Metodo HTTP.

UriQuery

Query URI.

Host

Informazioni sull'host dalla richiesta.

UserAgent

Nome agente utente.

Cookie

Cookie fornito dall'applicazione.

Referrer

Referrer.

ServerPort

Porta per il server.

ProtocolStatus

Stato del protocollo.

Win32Status

Stato win32.

MethodNum

Numero di metodo.

SubStatus

Stato secondario.

Commenti

La struttura HTTP_LOG_FIELDS_DATA è un parametro facoltativo (pLogData) nell'API HttpSendResponseEntityBody e HttpSendHttpResponse a partire dall'API HTTP versione 2.0. La struttura HTTP_LOG_FIELDS_DATA specifica i campi registrati nella risposta.

A meno che questa struttura non venga passata, la risposta non verrà registrata, anche quando la proprietà di registrazione del server è impostata su un gruppo di URL o su una sessione server. Le richieste non verranno registrate a meno che l'applicazione non superi la struttura HTTP_LOG_FIELDS_DATA con ogni risposta e la proprietà di registrazione sia impostata nella sessione del server o nel gruppo di URL. La maggior parte dei campi nella struttura HTTP_LOG_FIELDS_DATA può essere inizializzata dal campo corrispondente nella struttura HTTP_REQUEST , tuttavia alcuni dei campi di log sono noti solo all'applicazione; ad esempio, Win32Status e SubStatus. Questa struttura consente alle applicazioni di modificare i campi registrati. L'applicazione passa un puntatore NULL e una lunghezza zero per il membro corrispondente per disabilitare la registrazione per tale campo.

Le applicazioni devono fornire la struttura HTTP_LOG_FIELDS_DATA con l'ultima chiamata di invio. Se una risposta viene inviata con una singola chiamata a HttpSendHttpResponse, i dati di log devono essere forniti in questa chiamata. Se la risposta viene inviata su più chiamate di invio, i dati devono essere forniti con l'ultima chiamata a HttpSendResponseEntityBody.