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 |