Stop
Detiene una grabación en modo de registro de archivos.
Sintaxis
HRESULT Stop
([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 a un objeto IProfileCollection que contiene una colección de perfiles que se va a guardar.
pTraceMergeProperties
[in] Puntero a un 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 detuvo correctamente la grabación. |
E_INVALIDARG |
Uno o más argumentos no son válidos. |
E_WPRC_FAILED_TO_STOP_PROFILE |
La biblioteca no pudo detener un perfil en la colección de perfiles. Use IControlErrorInfo para obtener información detallada del error. |
E_WPRC_TRACE_MERGE_LOST_EVENTS |
Los eventos perdidos de la sesión seguimiento de eventos para Windows (ETW) y la combinación de los archivos del registro de seguimiento de eventos (ETL) de la sesión pueden crear un archivo ETL incompleto. |
Comentarios
Use esta función solo para perfiles que registran secuencialmente en un archivo. Una vez guardadas las sesiones, la grabación se detiene.