Compartilhar via


Método IHttpTraceContext::GetTraceActivityId

Retorna o identificador de atividade de rastreamento para o contexto de rastreamento.

Sintaxe

virtual LPCGUID GetTraceActivityId(  
) = 0;  

Parâmetros

Este método não aceita parâmetros.

Valor Retornado

Um ponteiro para um GUID constante; caso contrário, NULL.

Comentários

O comportamento desse método depende da implementação. Algumas implementações sempre retornam NULL, enquanto outras chamam o método IHttpRequest::GetRawHttpRequest em um ponteiro IHttpRequest interno e convertem o ponteiro de HTTP_REQUEST retornado em um const ponteiro GUID.

Cuidado

Como alguns implementadores retornam NULL, sempre verifique se o LPCGUID retornado não é NULL antes de executar qualquer operação nesses dados.

Notas para implementadores

Os implementadores IHttpTraceContext são responsáveis pelo gerenciamento de memória com esses dados; portanto, IHttpTraceContext os implementadores que usam alocação de memória dinâmica devem liberar ou chamar delete no ponteiro LPCGUID quando ele não for mais necessário.

Observações para chamadores

IHttpTraceContext os implementadores são responsáveis pelo gerenciamento de memória com esses dados; portanto, IHttpTraceContext os clientes não devem liberar ou chamar delete no ponteiro LPCGUID retornado quando esses dados não forem mais necessários. Além disso, os clientes não devem converter esses dados em um ponteiro que não seja um const ou alterar o estado da memória referenciada por esse LPCGUID; caso contrário, uma violação de acesso será gerada ou os dados se tornarão inválidos.

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

Tipo 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