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. La grabación continúa ejecutándose.

Sintaxis

HRESULT Save
  ([in] BSTR bstrFileName,
  [in] IProfileCollection* pProfileCollection,
  [in] ITraceMergeProperties* pTraceMergeProperties)
;

Parámetros

bstrFileName
[in] Nombre del archivo en el que se guardan los eventos combinados de las grabaciones de todos los perfiles.

pProfileCollection
[in] Puntero al objeto IProfileCollection que contiene una colección de perfiles que se va a guardar.

pTraceMergeProperties
[in] Puntero al objeto ITraceMergeProperties que contiene propiedades con las que combinar grabaciones.

Valor devuelto

En la tabla siguiente se describen los posibles valores devueltos.

Valor devuelto	Descripción
S_OK	La función guardó correctamente la grabación.
E_INVALIDARG	Uno o más argumentos no son válidos.
E_WPRC_FAILED_TO_SAVE_PROFILE	La biblioteca no pudo guardar un perfil en la colección de perfiles. Use IControlErrorInfo para obtener información detallada del error.
E_WPRC_TRACE_MERGE_LOST_EVENTS	La sesión seguimiento de eventos para Windows (ETW) perdió eventos y combinar los archivos del registro de seguimiento de eventos (ETL) de la sesión puede crear un archivo ETL incompleto.

Comentarios

Esta función solo se usa para perfiles que registran en búferes circulares. Una vez guardadas las sesiones, la grabación continúa ejecutándose.

Temas relacionados

IControlManager