IHttpTraceContext::GetTraceConfiguration, méthode

Article
07/19/2023

Retourne la configuration de trace pour le contexte de trace.

Syntaxe

virtual HRESULT GetTraceConfiguration(  
   IN OUT HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration  
) = 0;

Paramètres

pHttpTraceConfiguration
[IN] [OUT] Pointeur vers une structure de HTTP_TRACE_CONFIGURATION qui contient des informations pour la configuration de la trace.

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur	Définition
S_OK	Indique que l’opération a réussi.

Remarques

Appelez la GetTraceConfiguration méthode pour déterminer si un consommateur d’événements existe avant d’appeler la méthode RaiseTraceEvent .

Notes

Bien que les implémenteurs IHttpTraceContext actuels retournent uniquement S_OK à partir de GetTraceConfiguration, vous devez tester la réussite ou l’échec en transmettant le retourné HRESULT aux macros SUCCEEDED ou FAILED , respectivement, car l’implémentation peut changer.

Cohérence de thread

La plupart des implémenteurs de l’interface IHttpTraceContext sont thread safe si seule la GetTraceConfiguration méthode est appelée. L’appel de la méthode SetTraceConfiguration n’est pas garanti pour être thread safe.

Remarques pour les implémenteurs

Les implémenteurs de la GetTraceConfiguration méthode sont responsables de la copie de toutes les données internes dans la HTTP_TRACE_CONFIGURATION structure, car les appelants sont responsables de l’élimination de ces données quand elles ne sont plus nécessaires.

Remarques pour les appelants

Les appelants à la méthode sont responsables de l’élimination GetTraceConfiguration des données et de HTTP_TRACE_CONFIGURATION leurs champs lorsque ces données ne sont plus nécessaires.

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
IHttpTraceContext::SetTraceConfiguration, méthode

Partager via