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

Lihat juga

Struktur HTTP Server API Versi 2.0

HTTP_RESPONSE_V1

HTTP_RESPONSE_V2

HttpSendHttpResponse

HttpSendResponseEntityBody