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 pHttpTraceConfiguration
apunta . 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 |