Compartir a través de


IHttpTraceContext::SetTraceConfiguration (Método)

Establece la configuración de seguimiento para el contexto de seguimiento.

Sintaxis

virtual HRESULT SetTraceConfiguration(  
   IN HTTP_MODULE_ID moduleId,  
   IN HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration,  
   IN DWORD cHttpTraceConfiguration = 1  
) = 0;)  

Parámetros

moduleId
[IN] Puntero HTTP_MODULE_ID que contiene el identificador del módulo para la configuración de seguimiento.

pHttpTraceConfiguration
[IN] Matriz de estructuras de HTTP_TRACE_CONFIGURATION de longitud cHttpTraceConfiguration.

cHttpTraceConfiguration
[IN] que DWORD contiene el número de HTTP_TRACE_CONFIGURATION estructuras a las que pHttpTraceConfigurationapunta . El valor predeterminado es 1.

Nota

HTTP_MODULE_ID es una definición de tipo de un void puntero.

Valor devuelto

Una clase HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Value Definición
S_OK Indica que la operación se realizó correctamente.
E_FAIL Indica que se produjo un error en la operación.
E_OUTOFMEMORY Indica que una operación interna new devolvió NULL porque se agota la memoria del montón.
ERROR_INVALID_PARAMETER Indica que la HTTP_TRACE_CONFIGURATION::pProviderGuid propiedad del pHttpTraceConfiguration parámetro es NULL.
ERROR_NOT_FOUND Indica que se ha producido un intento de deshabilitar el seguimiento de un proveedor que no existe.

Comentarios

Ni el moduleId parámetro ni pHttpTraceConfiguration pueden ser NULL; de lo contrario, el SetTraceConfiguration método provocará una infracción de acceso.

Seguridad para subprocesos

La mayoría de los implementadores de la interfaz IHttpTraceContext son seguros para subprocesos si solo se llama al método GetTraceConfiguration . No se garantiza que la llamada al SetTraceConfiguration método sea segura para subprocesos.

Comentarios

Para obtener más información sobre cómo crear e implementar un módulo DLL nativo, consulte Tutorial: Creación de un módulo HTTP de Request-Level mediante código nativo.

Requisitos

Tipo Descripción
Remoto - IIS 7.0 en Windows Vista
- IIS 7.5 en Windows 7
- IIS 8.0 en Windows 8
- IIS 10.0 en Windows 10
Servidor - IIS 7.0 en Windows Server 2008
- IIS 7.5 en Windows Server 2008 R2
- IIS 8.0 en Windows Server 2012
- IIS 8.5 en Windows Server 2012 R2
- IIS 10.0 en Windows Server 2016
Producto - 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
Encabezado Httpserv.h

Consulte también

IHttpTraceContext (interfaz)