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 |