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 |