Partager via


IHttpTraceContext::GetTraceActivityId, méthode

Retourne l’identificateur d’activité de trace pour le contexte de trace.

Syntaxe

virtual LPCGUID GetTraceActivityId(  
) = 0;  

Paramètres

Cette méthode ne prend aucun paramètre.

Valeur renvoyée

Pointeur vers un GUID constant ; sinon, NULL.

Remarques

Le comportement de cette méthode dépend de l’implémentation. Certaines implémentations retournent toujours la valeur NULL, tandis que d’autres appellent la méthode IHttpRequest::GetRawHttpRequest sur un pointeur IHttpRequest interne et convertissent le pointeur HTTP_REQUEST retourné en pointeur const GUID.

Attention

Étant donné que certains implémenteurs retournent null, vérifiez toujours que le LPCGUID retourné n’est pas NULL avant d’effectuer des opérations sur ces données.

Remarques pour les implémenteurs

Les implémenteurs IHttpTraceContext sont responsables de la gestion de la mémoire avec ces données ; par conséquent, IHttpTraceContext les implémenteurs qui utilisent l’allocation de mémoire dynamique doivent libérer ou appeler delete le pointeur LPCGUID lorsqu’il n’est plus nécessaire.

Remarques pour les appelants

IHttpTraceContext les implémenteurs sont responsables de la gestion de la mémoire avec ces données ; par conséquent, IHttpTraceContext les clients ne doivent pas libérer ou appeler delete le pointeur LPCGUID retourné lorsque ces données ne sont plus nécessaires. En outre, les clients ne doivent pas caster ces données en un pointeur qui n’est pas un const ou modifier l’état de la mémoire référencée par ce LPCGUID ; sinon, une violation d’accès sera levée ou les données deviendront non valides.

Pour plus d’informations sur la création et le déploiement d’un module DLL natif, consultez Procédure pas à pas : création d’un module HTTP Request-Level à l’aide de code natif.

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sur Windows 8
- IIS 10.0 sur Windows 10
Serveur - IIS 7.0 sur Windows Server 2008
- IIS 7.5 sur Windows Server 2008 R2
- IIS 8.0 sur Windows Server 2012
- IIS 8.5 sur Windows Server 2012 R2
- IIS 10.0 sur Windows Server 2016
Produit - 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
En-tête Httpserv.h

Voir aussi

IHttpTraceContext, interface