Función RegisterTraceGuidsA (evntrace.h)

La función RegisterTraceGuids registra un proveedor de seguimiento de eventos ETW de clásico (estilo Windows 2000) y las clases de seguimiento de eventos que usa para generar eventos. Esta función también especifica la función de devolución de llamada que usa el sistema para habilitar y deshabilitar el seguimiento del proveedor.

Esta función está obsoleta. El nuevo código debe usar EventRegister para registrar un proveedor de seguimiento de eventos ETW de estilo de Windows Vista (Crimson).

Sintaxis

ULONG WMIAPI RegisterTraceGuidsA(
  [in]      WMIDPREQUEST             RequestAddress,
  [in]      PVOID                    RequestContext,
  [in]      LPCGUID                  ControlGuid,
  [in]      ULONG                    GuidCount,
  [in, out] PTRACE_GUID_REGISTRATION TraceGuidReg,
  [in]      LPCSTR                   MofImagePath,
  [in]      LPCSTR                   MofResourceName,
  [out]     TRACEGUID_HANDLE         *RegistrationHandle
);

Parámetros

[in] RequestAddress

Puntero a una función de ControlCallback que recibe una notificación cuando el proveedor está habilitado o deshabilitado por una sesión de seguimiento de eventos. La función EnableTrace desencadena esta devolución de llamada.

[in] RequestContext

Puntero a un contexto opcional definido por el proveedor que ETW pasa a la función especificada por RequestAddress.

[in] ControlGuid

GUID de control (id. de proveedor) del proveedor de registro.

[in] GuidCount

Número de elementos de la matriz traceGuidReg de . Si TraceGuidReg es NULL, establezca este parámetro en 0.

[in, out] TraceGuidReg

Puntero a una matriz de
estructuras de TRACE_GUID_REGISTRATION.

Cada elemento identifica una categoría de eventos que proporciona el proveedor.

En la entrada, el guid de miembro de cada estructura contiene un GUID de clase de seguimiento de eventos asignado por el proveedor de registro. El GUID de clase identifica una categoría de eventos que proporciona el proveedor. Los proveedores usan el mismo GUID de clase para establecer el miembro Guid de EVENT_TRACE_HEADER al llamar a la función traceEvent para registrar el evento.

En la salida, el miembro RegHandle recibe un identificador del registro guid de clase del evento. Si el proveedor llama a la función TraceEventInstance, use el miembro RegHandle de TRACE_GUID_REGISTRATION para establecer el miembro regHandle regHandle de EVENT_INSTANCE_HEADER.

Este parámetro puede ser NULL si el proveedor llama solo a la función traceEvent para registrar eventos. Si el proveedor llama a la función TraceEventInstance para registrar eventos, este parámetro no puede ser NULL.

[in] MofImagePath

Este parámetro no se admite. Establezca en null. Debe usar Mofcomp.exe para registrar el recurso MOF durante la configuración de la aplicación. Para obtener más información, vea publicar el esquema de eventos.

Windows XP con SP1, Windows XP y Windows 2000: Puntero a una cadena opcional que especifica la ruta de acceso del archivo DLL o programa ejecutable que contiene el recurso especificado por MofResourceName. Este parámetro puede ser NULL si el proveedor de eventos y el consumidor usan otro mecanismo para compartir información sobre las clases de seguimiento de eventos usadas por el proveedor.

[in] MofResourceName

Este parámetro no se admite. Establezca en null. Debe usar Mofcomp.exe para registrar el recurso MOF durante la configuración de la aplicación. Para obtener más información, vea publicar el esquema de eventos.

Windows XP con SP1, Windows XP y Windows 2000: Puntero a una cadena opcional que especifica el recurso de cadena de MofImagePath. El recurso de cadena contiene el nombre del archivo MOF binario que describe las clases de seguimiento de eventos compatibles con el proveedor.

[out] RegistrationHandle

Recibe el identificador de registro del proveedor. Use el identificador devuelto al llamar a la función UnregisterTraceGuids.

Valor devuelto

Si la función se ejecuta correctamente, se ERROR_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto es uno de los códigos de error del sistema . A continuación se muestran algunos errores comunes y sus causas.

• ERROR_INVALID_PARAMETER

  Se cumple una de las siguientes condiciones:

  • requestAddress es null.
  • controlGuid es NULL.
  • RegistrationHandle es NULL.

  Windows XP y Windows 2000:traceGuidReg es null o GuidCount es menor o igual que cero.

Observaciones

Esta función abre un identificador de proveedor de eventos de clásico de clásico (estilo Windows 2000) que se puede usar para escribir eventos ETW de MOF y TMF a través de TraceEvent, TraceEventInstance, TraceMessagey TraceMessageVa.

Si el controlGuid del proveedor se ha registrado y habilitado previamente, los registros posteriores que hacen referencia al mismo controlGuid se habilitan automáticamente.

Un proceso puede registrar hasta 1024 GUID de proveedor; sin embargo, debe limitar el número de proveedores que el proceso registra en uno o dos. Este límite incluye los registrados mediante esta función y la función EventRegister.

Antes de Windows Vista: No hay ningún límite para el número de proveedores que un proceso puede registrar.

Ejemplos

Para obtener un ejemplo que usa RegisterTraceGuids, vea Escritura de eventos clásicos.

Requisitos

Consulte también

enableTrace

UnregisterTraceGuids