Configurazione e abilitazione della registrazione lato server

L'applicazione abilita la registrazione nella sessione del server o nel gruppo di URL prima di inviare la risposta con HttpSendHttpResponse. L'esempio seguente illustra come configurare e abilitare la registrazione lato server di tipo W3C:

1. L'applicazione inizializza la struttura HTTP_LOGGING_INFO con HttpLoggingTypeW3C specificato nel membro Format e una maschera di bit delle costanti HTTP_LOG_FIELD nel membro Fields.
2. L'applicazione chiama HttpSetServerSessionProperty o HttpSetUrlGroupProperty con HttpServerLoggingProperty specificato nel parametro Property e un puntatore alla struttura HTTP_LOGGING_INFO nel parametro pPropertyInformation.

La maschera di bit delle costanti HTTP_LOG_FIELD contiene i campi che possono essere registrati nel file di log W3C. Si noti che l'impostazione della proprietà HttpServerLoggingProperty in una sessione del server o in un gruppo di URL non significa che le risposte HTTP verranno registrate. La registrazione viene eseguita per ogni richiesta quando W3C è abilitato nella chiamata a HttpSendHttpResponse o HttpSendResponseEntityBody.

Per abilitare la registrazione delle risposte W3C per ogni richiesta, l'applicazione esegue i passaggi seguenti:

1. L'applicazione inizializza i membri del HTTP_LOG_FIELDS_DATA con le informazioni sul campo che verranno registrate per tale risposta.
2. Il membro di Base.Type della struttura HTTP_LOG_FIELDS_DATA deve essere inizializzato per HttpLogDataTypeFields. Il campo base.type garantisce l'estendibilità futura della struttura e dell'API.
3. L'applicazione chiama HttpSendHttpResponse o HttpSendResponseEntityBody con un puntatore alla struttura HTTP_LOG_FIELDS_DATA nel parametro pLogData. L'applicazione deve effettuare il cast del puntatore a PHTTP_LOG_DATA.