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 |