Método IHttpTraceContext::SetTraceConfiguration
Define a configuração de rastreamento para o contexto de rastreamento.
Sintaxe
virtual HRESULT SetTraceConfiguration(
IN HTTP_MODULE_ID moduleId,
IN HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration,
IN DWORD cHttpTraceConfiguration = 1
) = 0;)
Parâmetros
moduleId
[IN] Um HTTP_MODULE_ID ponteiro que contém o identificador do módulo para a configuração de rastreamento.
pHttpTraceConfiguration
[IN] Uma matriz de estruturas de HTTP_TRACE_CONFIGURATION de comprimento cHttpTraceConfiguration.
cHttpTraceConfiguration
[IN] Um DWORD que contém o número de HTTP_TRACE_CONFIGURATION estruturas apontadas por pHttpTraceConfiguration. O padrão é 1.
Observação
HTTP_MODULE_ID é uma definição de tipo de um void ponteiro.
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. |
| E_FAIL | Indica que a operação falhou. |
| E_OUTOFMEMORY | Indica que uma operação interna new retornou NULL porque a memória do heap está esgotada. |
| ERROR_INVALID_PARAMETER | Indica que a HTTP_TRACE_CONFIGURATION::pProviderGuid propriedade do pHttpTraceConfiguration parâmetro é NULL. |
| ERROR_NOT_FOUND | Indica que ocorreu uma tentativa de desabilitar o rastreamento para um provedor que não existe. |
Comentários
Nem o moduleId parâmetro nem pHttpTraceConfiguration pode ser NULL; caso contrário, o SetTraceConfiguration método causará uma violação de acesso.
Acesso thread-safe
A maioria dos implementadores da interface IHttpTraceContext são thread safe se apenas o método GetTraceConfiguration for chamado. Não há garantia de que chamar o SetTraceConfiguration método seja thread safe.
Comentá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 |