Compartilhar via


estrutura HTTP_LOG_FIELDS_DATA (http.h)

A estrutura HTTP_LOG_FIELDS_DATA é usada para passar os campos registrados para uma resposta HTTP quando o registro em log do WC3 está habilitado.

Sintaxe

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;

Membros

Base

Inicialize esse membro para o valor HttpLogDataTypeFields da enumeração HTTP_LOG_DATA_TYPE .

UserNameLength

O tamanho, em bytes, do membro de nome de usuário.

UriStemLength

O tamanho, em bytes, do membro-tronco do URI.

ClientIpLength

O tamanho, em bytes, do membro do endereço IP do cliente.

ServerNameLength

O tamanho, em bytes, do membro do nome do servidor.

ServiceNameLength

ServerIpLength

O tamanho, em bytes, do membro do endereço IP do servidor.

MethodLength

O tamanho, em bytes, do membro do método HTTP.

UriQueryLength

O tamanho, em bytes, do membro de consulta URI.

HostLength

O tamanho, em bytes, do membro do nome do host.

UserAgentLength

O tamanho, em bytes, do membro do agente do usuário.

CookieLength

O tamanho, em bytes, do membro do cookie.

ReferrerLength

O tamanho, em bytes, do membro referenciador.

UserName

O nome do usuário.

UriStem

O caule de URI.

ClientIp

O endereço IP do cliente.

ServerName

O nome do servidor.

ServiceName

O nome do serviço.

ServerIp

O endereço IP do servidor.

Method

O método HTTP.

UriQuery

A consulta URI.

Host

As informações do host da solicitação.

UserAgent

O nome do agente de usuário.

Cookie

O cookie fornecido pelo aplicativo.

Referrer

O referenciador.

ServerPort

A porta do servidor.

ProtocolStatus

O protocolo status.

Win32Status

O status win32.

MethodNum

O número do método.

SubStatus

O sub-status.

Comentários

A estrutura HTTP_LOG_FIELDS_DATA é um parâmetro opcional (pLogData) nas funções HttpSendResponseEntityBody e HttpSendHttpResponse começando com a API HTTP versão 2.0. A estrutura HTTP_LOG_FIELDS_DATA especifica quais campos são registrados na resposta.

A menos que essa estrutura seja passada, a resposta não será registrada, mesmo quando a propriedade de log do servidor for definida em um grupo de URLs ou em uma sessão de servidor. As solicitações não serão registradas, a menos que o aplicativo passe a estrutura HTTP_LOG_FIELDS_DATA com cada resposta e a propriedade de registro em log seja definida na sessão do servidor ou no Grupo de URLs. A maioria dos campos na estrutura HTTP_LOG_FIELDS_DATA pode ser inicializada do campo correspondente na estrutura HTTP_REQUEST , no entanto, alguns dos campos de log são conhecidos apenas pelo aplicativo; por exemplo, Win32Status e SubStatus. Essa estrutura permite que os aplicativos alterem os campos registrados. O aplicativo passa um ponteiro NULL e um comprimento zero para o membro correspondente desabilitar o registro em log para esse campo.

Os aplicativos devem fornecer a estrutura HTTP_LOG_FIELDS_DATA com a última chamada de envio. Se uma resposta for enviada com uma única chamada para HttpSendHttpResponse, os dados de log deverão ser fornecidos nessa chamada. Se a resposta for enviada por várias chamadas de envio, os dados deverão ser fornecidos com a última chamada para HttpSendResponseEntityBody.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho http.h

Confira também

Estruturas da API do Servidor HTTP versão 2.0

HTTP_RESPONSE_V1

HTTP_RESPONSE_V2

HttpSendHttpResponse

HttpSendResponseEntityBody