IHttpTraceContext::GetTraceConfiguration (Método)

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

Sintaxis

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

Parámetros

pHttpTraceConfiguration
[IN] [OUT] Puntero a una estructura de HTTP_TRACE_CONFIGURATION que contiene información para la configuración de seguimiento.

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.

Comentarios

Llame al GetTraceConfiguration método para determinar si existe un consumidor de eventos antes de llamar al método RaiseTraceEvent .

Nota

Aunque los implementadores de IHttpTraceContext actuales devuelven solo S_OK de GetTraceConfiguration, debe probar si la operación se realizó correctamente o no pasando las HRESULT macros SUCCEEDED o FAILED , respectivamente, porque la implementación puede cambiar.

Seguridad para subprocesos

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

Notas para los implementadores

Los implementadores del GetTraceConfiguration método son responsables de copiar los datos internos en la HTTP_TRACE_CONFIGURATION estructura, ya que los llamadores son responsables de eliminar estos datos cuando ya no son necesarios.

Notas para autores de la llamada

Los autores de llamadas al GetTraceConfiguration método son responsables de eliminar los HTTP_TRACE_CONFIGURATION datos y sus campos cuando estos datos ya no son necesarios.

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)
IHttpTraceContext::SetTraceConfiguration (Método)