IHttpTraceContext::SetTraceConfiguration, méthode
Définit la configuration de trace pour le contexte de trace.
Syntaxe
virtual HRESULT SetTraceConfiguration(
IN HTTP_MODULE_ID moduleId,
IN HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration,
IN DWORD cHttpTraceConfiguration = 1
) = 0;)
Paramètres
moduleId
[IN] Pointeur HTTP_MODULE_ID qui contient l’identificateur de module pour la configuration de trace.
pHttpTraceConfiguration
[IN] Tableau de structures HTTP_TRACE_CONFIGURATION de longueur cHttpTraceConfiguration.
cHttpTraceConfiguration
[IN] DWORD qui contient le nombre de HTTP_TRACE_CONFIGURATION structures pointées par pHttpTraceConfiguration. La valeur par défaut est 1.
Notes
HTTP_MODULE_ID est une définition de type d’un void pointeur.
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. |
| E_FAIL | Indique que l’opération a échoué. |
| E_OUTOFMEMORY | Indique qu’une opération interne new a retourné null, car la mémoire du tas est épuisée. |
| ERROR_INVALID_PARAMETER | Indique que la HTTP_TRACE_CONFIGURATION::pProviderGuid propriété du pHttpTraceConfiguration paramètre est NULL. |
| ERROR_NOT_FOUND | Indique qu’une tentative de désactivation du suivi s’est produite pour un fournisseur qui n’existe pas. |
Remarques
Ni le moduleId paramètre ni ne pHttpTraceConfiguration peuvent être NULL ; sinon, la SetTraceConfiguration méthode entraîne une violation d’accès.
Cohérence de thread
La plupart des implémenteurs de l’interface IHttpTraceContext sont thread-safe si seule la méthode GetTraceConfiguration est appelée. Il n’est pas garanti que l’appel de la SetTraceConfiguration méthode soit thread-safe.
Commentaires
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 |