HTTP_LOGGING_INFO struttura (http.h)

La struttura HTTP_LOGGING_INFO viene usata per abilitare la registrazione lato server in un gruppo di URL o in una sessione server.

Questa struttura deve essere usata quando si imposta o si esegue una query su HttpServerLoggingProperty in una sessione url Group o server.

Sintassi

typedef struct _HTTP_LOGGING_INFO {
  HTTP_PROPERTY_FLAGS        Flags;
  ULONG                      LoggingFlags;
  PCWSTR                     SoftwareName;
  USHORT                     SoftwareNameLength;
  USHORT                     DirectoryNameLength;
  PCWSTR                     DirectoryName;
  HTTP_LOGGING_TYPE          Format;
  ULONG                      Fields;
  PVOID                      pExtFields;
  USHORT                     NumOfExtFields;
  USHORT                     MaxRecordSize;
  HTTP_LOGGING_ROLLOVER_TYPE RolloverType;
  ULONG                      RolloverSize;
  PSECURITY_DESCRIPTOR       pSecurityDescriptor;
} HTTP_LOGGING_INFO, *PHTTP_LOGGING_INFO;

Members

Flags

Struttura HTTP_PROPERTY_FLAGS che specifica se la proprietà è presente.

LoggingFlags

I flag di registrazione facoltativi modificano il comportamento di registrazione predefinito.

Questi valori possono essere uno o più dei seguenti valori HTTP_LOGGING_FLAG :

SoftwareName

Stringa di nome software facoltativa usata nella registrazione dei tipi W3C. Questo nome non viene usato per altri tipi di registrazione. Se questo parametro è NULL, l'API SERVER HTTP registra una stringa predefinita.

SoftwareNameLength

Lunghezza, in byte, del nome del software. La lunghezza non può essere maggiore di MAX_PATH.

Se il membro SoftwareName è NULL, questa lunghezza deve essere zero.

DirectoryNameLength

Lunghezza, in byte, del nome della directory. La lunghezza non può essere maggiore di 424 byte.

DirectoryName

Directory di registrazione in cui vengono creati i file di log. La stringa di directory deve essere un percorso completo, incluso la lettera di unità.

Le applicazioni possono usare un percorso UNC per un computer remoto per abilitare la registrazione UNC.

Format

Membro dell'enumerazione HTTP_LOGGING_TYPE che specifica uno dei formati di file di log seguenti.

Fields

I campi registrati quando il formato è impostato su W3C. Questi valori possono essere uno o più dei valori costanti HTTP_LOG_FIELD_ .

Quando il formato di registrazione è W3C, le applicazioni devono specificare i campi di log altrimenti non vengono registrati campi.

pExtFields

Riservato. Impostare su 0 (zero) o NULL.

NumOfExtFields

Riservato. Impostare su 0 (zero) o NULL.

MaxRecordSize

Riservato. Impostare su 0 (zero) o NULL.

RolloverType

Uno dei membri seguenti dell'enumerazione HTTP_LOGGING_ROLLOVER_TYPE specificando i criteri per il rollover dei file di log.

RolloverSize

Dimensioni massime, in byte, dopo il roll over dei file di log. Un valore di HTTP_LIMIT_INFINITE indica una dimensione illimitata. Il valore minimo non può essere minore di HTTP_MIN_ALLOWED_LOG_FILE_ROLLOVER_SIZE (1024 * 1024).

Questo campo viene usato solo per il tipo di rollover HttpLoggingRolloverSize e deve essere impostato su zero per tutti gli altri tipi.

Quando il tipo di rollover è HttpLoggingRolloverSize, le applicazioni devono specificare le dimensioni massime per il file di log.

pSecurityDescriptor

Descrittore di sicurezza applicato alla directory dei file di log e a tutte le sotto directory. Se questo membro è NULL, l'ACL predefinito del sistema viene usato o l'ACL viene ereditato dalla directory padre.

Commenti

La proprietà HttpServerLoggingProperty imposta uno dei quattro tipi di registrazione lato server: HttpLoggingTypeW3C, HttpLoggingTypeIIS, HttpLoggingTypeNCSA o HttpLoggingTypeRaw. Quando questa proprietà viene impostata in una sessione server, funziona come forma centralizzata di registrazione per tutti i gruppi di URL nella sessione del server. Le richieste indirizzate a uno dei gruppi di URL nella sessione del server vengono registrate in un file di log centralizzato. I parametri di configurazione per il file di log vengono passati nella struttura HTTP_LOGGING_INFO nella chiamata a HttpSetServerSessionProperty.

Quando questa proprietà è impostata su un gruppo di URL, la registrazione viene eseguita solo sulle richieste indirizzate al gruppo DI URL. I file di log vengono creati quando la richiesta arriva nella sessione del gruppo di URL o del server, non vengono creati quando viene configurata la registrazione.

Le applicazioni devono assicurarsi che la directory specificata nel membro DirectoryName sia univoca.

I nomi dei file di log si basano sul tipo di rollover specificato. Nella tabella seguente vengono illustrate le convenzioni di denominazione per i file di log.

Le lettere y, mm, ww, dd, hh e nn nella tabella rappresentano le cifre seguenti:

• y: rappresentazione a due cifre dell'anno.
• mm: rappresentazione a due cifre del mese.
• ww: rappresentazione a due cifre della settimana.
• dd: rappresentazione di due cifre del giorno.
• hh: rappresentazione a due cifre dell'ora nella notazione di 24 ore.
• nn: rappresentazione a due cifre della sequenza numerica.

Si noti che nell'API HTTP versione 2.0, httpSendHttpResponse e HttpSendResponseEntityBody sono stati revisionati per consentire alle applicazioni di passare una struttura HTTP_LOG_FIELDS_DATA in modo che sia possibile registrare la risposta. L'impostazione della proprietà HttpServerLoggingProperty in una sessione server o in un gruppo DI URL non significa che le risposte HTTP vengono registrate. L'accesso al gruppo URL o alla sessione del server non verrà eseguito a meno che le chiamate a HttpSendResponseEntityBody e HttpSendHttpResponse includono una struttura di HTTP_LOG_FIELDS_DATA facoltativa. Per altre informazioni, vedere l'argomento HTTP_LOG_FIELDS_DATA .

Per informazioni sui formati di file di log, vedere l'argomento Formati file di log IIS .

Requisiti

Vedi anche

Strutture dell'API SERVER HTTP versione 2.0

costanti HTTP_LOGGING_FLAG_

HTTP_LOGGING_ROLLOVER_TYPE

HTTP_LOGGING_TYPE

costanti HTTP_LOG_FIELD_

HTTP_SERVER_PROPERTY

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpSetRequestQueueProperty

HttpShutdownRequestQueue