Freigeben über


HTTP_LOG_FIELDS_DATA-Struktur (http.h)

Die HTTP_LOG_FIELDS_DATA-Struktur wird verwendet, um die Felder zu übergeben, die für eine HTTP-Antwort protokolliert werden, wenn die WC3-Protokollierung aktiviert ist.

Syntax

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;

Member

Base

Initialisieren Sie dieses Member mit dem HttpLogDataTypeFields-Wert der HTTP_LOG_DATA_TYPE-Enumeration .

UserNameLength

Die Größe des Benutzernamenelements in Bytes.

UriStemLength

Die Größe des URI-Stammelements in Bytes.

ClientIpLength

Die Größe des Client-IP-Adresselements in Bytes.

ServerNameLength

Die Größe des Servernamenselements in Bytes.

ServiceNameLength

ServerIpLength

Die Größe des Server-IP-Adresselements in Bytes.

MethodLength

Die Größe des HTTP-Methodenelements in Bytes.

UriQueryLength

Die Größe des URI-Abfragemembers in Bytes.

HostLength

Die Größe des Hostnamenelements in Bytes.

UserAgentLength

Die Größe des Benutzer-Agent-Members in Bytes.

CookieLength

Die Größe des Cookieelements in Bytes.

ReferrerLength

Die Größe des Verweiselements in Bytes.

UserName

Der Name des Benutzers.

UriStem

Der URI-Stamm.

ClientIp

Die IP-Adresse des Clients.

ServerName

Name des Servers

ServiceName

Der Name des Diensts.

ServerIp

Die IP-Adresse des Servers.

Method

Die HTTP-Methode.

UriQuery

Die URI-Abfrage.

Host

Die Hostinformationen aus der Anforderung.

UserAgent

Der Name des Benutzer-Agents.

Cookie

Das von der Anwendung bereitgestellte Cookie.

Referrer

Der Verweis.

ServerPort

Der Port für den Server.

ProtocolStatus

Das Protokoll status.

Win32Status

Die win32-status.

MethodNum

Die Methodennummer.

SubStatus

Der Unter-status.

Hinweise

Die HTTP_LOG_FIELDS_DATA-Struktur ist ein optionaler Parameter (pLogData) in den Funktionen HttpSendResponseEntityBody und HttpSendHttpResponse ab der HTTP-API 2.0. Die HTTP_LOG_FIELDS_DATA-Struktur gibt an, welche Felder in der Antwort protokolliert werden.

Wenn diese Struktur nicht übergeben wird, wird die Antwort nicht protokolliert, auch wenn die Serverprotokollierungseigenschaft für eine URL-Gruppe oder Serversitzung festgelegt ist. Anforderungen werden nur protokolliert, wenn die Anwendung die HTTP_LOG_FIELDS_DATA Struktur mit jeder Antwort übergibt und die Protokollierungseigenschaft für die Serversitzung oder URL-Gruppe festgelegt ist. Die meisten Felder in der HTTP_LOG_FIELDS_DATA-Struktur können aus dem entsprechenden Feld in der HTTP_REQUEST-Struktur initialisiert werden, einige der Protokollfelder sind jedoch nur der Anwendung bekannt; Beispiel: Win32Status und SubStatus. Mit dieser Struktur können Anwendungen die protokollierten Felder ändern. Die Anwendung übergibt einen NULL-Zeiger und eine Länge null für das entsprechende Element, um die Protokollierung für dieses Feld zu deaktivieren.

Anwendungen müssen die HTTP_LOG_FIELDS_DATA-Struktur mit dem letzten Sendeaufruf bereitstellen. Wenn eine Antwort mit einem einzelnen Aufruf von HttpSendHttpResponse gesendet wird, müssen die Protokolldaten in diesem Aufruf bereitgestellt werden. Wenn die Antwort über mehrere Sendeanrufe gesendet wird, müssen die Daten mit dem letzten Aufruf von HttpSendResponseEntityBody bereitgestellt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile http.h

Weitere Informationen

HTTP-Server-API, Version 2.0-Strukturen

HTTP_RESPONSE_V1

HTTP_RESPONSE_V2

HttpSendHttpResponse

HttpSendResponseEntityBody