Método IHttpTraceContext::GetTraceConfiguration

Retorna a configuração de rastreamento para o contexto de rastreamento.

Sintaxe

virtual HRESULT GetTraceConfiguration(  
   IN OUT HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration  
) = 0;  

Parâmetros

pHttpTraceConfiguration
[IN] [OUT] Um ponteiro para uma estrutura HTTP_TRACE_CONFIGURATION que contém informações para a configuração de rastreamento.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor	Definição
S_OK	Indica que a operação foi bem-sucedida.

Comentários

Chame o GetTraceConfiguration método para determinar se um consumidor de evento existe antes de chamar o método RaiseTraceEvent .

Observação

Embora os implementadores IHttpTraceContext atuais retornem apenas S_OK de GetTraceConfiguration, você deve testar o sucesso ou a falha passando o retornado HRESULT para as macros SUCCEEDED ou FAILED , respectivamente, porque a implementação pode mudar.

Acesso thread-safe

A maioria dos implementadores da interface IHttpTraceContext é thread-safe se apenas o GetTraceConfiguration método for chamado. Não há garantia de que chamar o método SetTraceConfiguration seja thread-safe.

Notas para implementadores

Os implementadores do GetTraceConfiguration método são responsáveis por copiar quaisquer dados internos para a HTTP_TRACE_CONFIGURATION estrutura, pois os chamadores são responsáveis por descartar esses dados quando eles não são mais necessários.

Observações para chamadores

Os chamadores para o GetTraceConfiguration método são responsáveis por descartar quaisquer HTTP_TRACE_CONFIGURATION dados e seus campos quando esses dados não são mais necessários.

Para obter mais informações sobre como criar e implantar um módulo DLL nativo, consulte Passo a passo : criando um módulo HTTP Request-Level usando código nativo.

Requisitos

Type	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Produto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
parâmetro	Httpserv.h

Consulte Também

IHttpTraceContext Interface
Método IHttpTraceContext::SetTraceConfiguration