estructura de HTTP_LOG_FIELDS_DATA (http.h)

La estructura de HTTP_LOG_FIELDS_DATA se usa para pasar los campos registrados para una respuesta HTTP cuando se habilita el registro wc3.

Sintaxis

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;

Miembros

Base

Inicialice este miembro en el valor HttpLogDataTypeFields de la enumeración HTTP_LOG_DATA_TYPE .

UserNameLength

Tamaño, en bytes, del miembro de nombre de usuario.

UriStemLength

Tamaño, en bytes, del miembro raíz del URI.

ClientIpLength

Tamaño, en bytes, del miembro de dirección IP del cliente.

ServerNameLength

Tamaño, en bytes, del miembro de nombre del servidor.

ServiceNameLength

ServerIpLength

Tamaño, en bytes, del miembro de dirección IP del servidor.

MethodLength

Tamaño, en bytes, del miembro del método HTTP.

UriQueryLength

Tamaño, en bytes, del miembro de consulta URI.

HostLength

Tamaño, en bytes, del miembro de nombre de host.

UserAgentLength

Tamaño, en bytes, del miembro del agente de usuario.

CookieLength

Tamaño, en bytes, del miembro de cookie.

ReferrerLength

Tamaño, en bytes, del miembro de referencia.

UserName

Nombre del usuario.

UriStem

El tallo del URI.

ClientIp

Dirección IP del cliente.

ServerName

El nombre del servidor.

ServiceName

El nombre del servicio.

ServerIp

Dirección IP del servidor.

Method

Método HTTP.

UriQuery

Consulta de URI.

Host

Información del host de la solicitud.

UserAgent

Nombre del agente de usuario.

Cookie

Cookie proporcionada por la aplicación.

Referrer

El remitente.

ServerPort

Puerto del servidor.

ProtocolStatus

Estado del protocolo.

Win32Status

Estado win32.

MethodNum

Número de método.

SubStatus

Subestado.

Comentarios

La estructura HTTP_LOG_FIELDS_DATA es un parámetro opcional (pLogData) en las funciones HttpSendResponseEntityBody y HttpSendHttpResponse a partir de la API http versión 2.0. La estructura HTTP_LOG_FIELDS_DATA especifica qué campos se registran en la respuesta.

A menos que se pase esta estructura, la respuesta no se registrará, incluso cuando la propiedad de registro del servidor esté establecida en un grupo de direcciones URL o en una sesión de servidor. Las solicitudes no se registrarán a menos que la aplicación pase la estructura de HTTP_LOG_FIELDS_DATA con cada respuesta y la propiedad de registro esté establecida en la sesión del servidor o en el grupo de direcciones URL. La mayoría de los campos de la estructura HTTP_LOG_FIELDS_DATA se pueden inicializar desde el campo correspondiente de la estructura HTTP_REQUEST , sin embargo, algunos de los campos de registro solo se conocen para la aplicación; por ejemplo, Win32Status y SubStatus. Esta estructura permite a las aplicaciones modificar los campos registrados. La aplicación pasa un puntero NULL y una longitud cero para el miembro correspondiente para deshabilitar el registro de ese campo.

Las aplicaciones deben proporcionar la estructura HTTP_LOG_FIELDS_DATA con la última llamada de envío. Si se envía una respuesta con una sola llamada a HttpSendHttpResponse, los datos de registro deben proporcionarse en esta llamada. Si la respuesta se envía a través de varias llamadas de envío, los datos se deben proporcionar con la última llamada a HttpSendResponseEntityBody.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	http.h

Consulte también

Estructuras de la API de servidor HTTP versión 2.0

HTTP_RESPONSE_V1

HTTP_RESPONSE_V2

HttpSendHttpResponse

HttpSendResponseEntityBody