struktur HTTP_LOG_FIELDS_DATA (http.h)
Struktur HTTP_LOG_FIELDS_DATA digunakan untuk meneruskan bidang yang dicatat untuk respons HTTP saat pengelogan WC3 diaktifkan.
Sintaks
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;
Anggota
Base
Inisialisasi anggota ini ke nilai HttpLogDataTypeFields dari enumerasi HTTP_LOG_DATA_TYPE .
UserNameLength
Ukuran, dalam byte, dari anggota nama pengguna.
UriStemLength
Ukuran, dalam byte, dari anggota batang URI.
ClientIpLength
Ukuran, dalam byte, dari anggota alamat IP klien.
ServerNameLength
Ukuran, dalam byte, dari anggota nama server.
ServiceNameLength
ServerIpLength
Ukuran, dalam byte, dari anggota alamat IP server.
MethodLength
Ukuran, dalam byte, dari anggota metode HTTP.
UriQueryLength
Ukuran, dalam byte, dari anggota kueri URI.
HostLength
Ukuran, dalam byte, dari anggota nama host.
UserAgentLength
Ukuran, dalam byte, dari anggota agen pengguna.
CookieLength
Ukuran, dalam byte, anggota cookie.
ReferrerLength
Ukuran, dalam byte, dari anggota referen.
UserName
Nama pengguna.
UriStem
Batang URI.
ClientIp
Alamat IP klien.
ServerName
Nama server.
ServiceName
Nama layanan.
ServerIp
Alamat IP server.
Method
Metode HTTP.
UriQuery
Kueri URI.
Host
Informasi host dari permintaan.
UserAgent
Nama agen pengguna.
Cookie
Cookie yang disediakan oleh aplikasi.
Referrer
Perujuk.
ServerPort
Port untuk server.
ProtocolStatus
Status protokol.
Win32Status
Status win32.
MethodNum
Nomor metode.
SubStatus
Sub status.
Keterangan
Struktur HTTP_LOG_FIELDS_DATA adalah parameter opsional (pLogData) di fungsi HttpSendResponseEntityBody dan HttpSendHttpResponse yang dimulai dengan API HTTP versi 2.0. Struktur HTTP_LOG_FIELDS_DATA menentukan bidang mana yang dicatat dalam respons.
Kecuali struktur ini diteruskan, respons tidak akan dicatat, bahkan ketika properti pengelogan server diatur pada grup URL atau sesi server. Permintaan tidak akan dicatat kecuali aplikasi melewati struktur HTTP_LOG_FIELDS_DATA dengan setiap respons dan properti pengelogan diatur pada sesi server atau Grup URL. Sebagian besar bidang dalam struktur HTTP_LOG_FIELDS_DATA dapat diinisialisasi dari bidang yang sesuai dalam struktur HTTP_REQUEST , namun, beberapa bidang log hanya diketahui oleh aplikasi; misalnya, Win32Status dan SubStatus. Struktur ini memungkinkan aplikasi untuk mengubah bidang yang dicatat. Aplikasi meneruskan penunjuk NULL dan panjang nol bagi anggota terkait untuk menonaktifkan pengelogan untuk bidang tersebut.
Aplikasi harus menyediakan struktur HTTP_LOG_FIELDS_DATA dengan panggilan pengiriman terakhir. Jika respons dikirim dengan satu panggilan ke HttpSendHttpResponse, data log harus disediakan dalam panggilan ini. Jika respons dikirim melalui beberapa panggilan pengiriman, data harus diberikan panggilan terakhir ke HttpSendResponseEntityBody.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | http.h |