IControlManager

Representa el administrador de Windows Performance Recorder, que controla las sesiones de Seguimiento de eventos para Windows (ETW). El cliente pasa una colección de perfiles mediante la interfaz IProfileCollection y el administrador puede iniciar, actualizar, cancelar, guardar, detener o consultar la sesión de ETW o los proveedores que describe cada perfil. El cliente puede pasar un puntero al controlador IControlProgressHandler para recibir actualizaciones sobre la operación que realiza el administrador.

Sintaxis

{
  [propget, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([out, retval] IControlProgressHandler** ppControlProgressHandler);
  [propput, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([in] IControlProgressHandler* pControlProgressHandler);
  [id(2), helpstring("Start")] HRESULT Start
    ([in] IProfileCollection* pProfileCollection);
  [id(3), helpstring("Update")] HRESULT Update
    ([in] IProfileCollection* pProfileCollection);
  [id(4), helpstring("Cancel")] HRESULT Cancel
    ([in] IProfileCollection* pProfileCollection);
  [id(5), helpstring("Save")] HRESULT Save
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(6), helpstring("Stop")] HRESULT Stop
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(7), helpstring("QueryXML")] HRESULT QueryXML
    ([out] BSTR* pbstrResults,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [id(8), helpstring("Query")] HRESULT Query
    ([out] IProfileCollection** ppProfileCollection,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [propget, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([out, retval] ITraceMergeTextHandler** ppTraceMergeTextHandler);
  [propput, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([in] ITraceMergeTextHandler* pTraceMergeTextHandler);
  [propget, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([out, retval] BSTR* pbstrTemporaryTraceDirectory);
  [propput, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([in] BSTR bstrTemporaryTraceDirectory);
  [id(11), helpstring("GetProviderNameFromGuid")] HRESULT GetProviderNameFromGuid
    ([out] BSTR* bstrProviderIdStr,
    [in] REFGUID ProviderId);
  [id(12), helpstring("GetProviderGuidFromName")] HRESULT GetProviderGuidFromName
    ([out] GUID* ProviderId,
    [in] BSTR bstrProViderName);
};

Functions

En la tabla siguiente se describen las funciones que proporciona esta interfaz.

Función	Descripción
Iniciar	Inicia una grabación.
Actualizar	Novedades una colección de perfiles.
Cancelar	Detiene una grabación sin guardar ningún dato.
Guardar	Guarda una grabación que se registra en búferes circulares en memoria en el archivo de registro de seguimiento de eventos (ETL) especificado.
Detención	Detiene una grabación y la guarda en el archivo de registro de seguimiento de eventos (ETL) especificado.
QueryXML	Indica el formato XML del perfil que se está ejecutando actualmente y si el perfil se está ejecutando correctamente.
Consultar	Consulta las propiedades de la sesión y los proveedores en todos los perfiles.
propget	Obtiene la propiedad especificada.
propput	Establece la propiedad especificada.
GetProviderNameFromGuid	Obtiene el nombre del proveedor del GUID especificado.
GetProviderGuidFromName	Obtiene el GUID del proveedor del nombre especificado.

Propiedades

En la tabla siguiente se describen los parámetros de las propiedades que esta interfaz puede obtener o establecer.

Propiedad	Parámetros	Descripción
ControlProgressHandler	ppControlProgressHandler [out]	Puntero a la implementación del lado cliente de la interfaz IControlProgressHandler .
ControlProgressHandler	pControlProgressHandler [in]	Puntero a la implementación del lado cliente de la interfaz IControlProgressHandler . E_POINTER indica un puntero no válido.
TraceMergeTextHandler	ppTraceMergeTextHandler [out]	Puntero al texto y otra información de tiempo de combinación en el seguimiento insertado por la interfaz ITraceMergeTextHandler .
TraceMergeTextHandler	pTraceMergeTextHandler [in]	Puntero al texto y otra información de tiempo de combinación en el seguimiento insertado por la interfaz ITraceMergeTextHandler . E_POINTER indica un puntero no válido.
TemporaryTraceDirectory	pbstrTemporaryTraceDirectory [out]	Puntero a la ruta de acceso del directorio donde se registran los archivos de seguimiento combinados previamente. El valor predeterminado es la carpeta %temp%.
TemporaryTraceDirectory [in]	bstrTemporaryTraceDirectory	Ruta de acceso del directorio donde se registran los archivos de seguimiento combinados previamente.

Temas relacionados

Interfaces