Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
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