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 |