Stop
Interrompe uma gravação no modo de registro em log de arquivos.
Sintaxe
HRESULT Stop
([in] BSTR bstrFileName,
[in] IProfileCollection* pProfileCollection,
[in] ITraceMergeProperties* pTraceMergeProperties)
;
Parâmetros
bstrFileName
[in] O nome do arquivo no qual os eventos mesclados de gravações de todos os perfis são salvos.
pProfileCollection
[in] Um ponteiro para um objeto IProfileCollection que contém uma coleção de perfis a serem salvos.
pTraceMergeProperties
[in] Um ponteiro para um objeto ITraceMergeProperties que contém propriedades com as quais mesclar gravações.
Valor Retornado
A tabela a seguir descreve possíveis valores retornados.
| Valor Retornado | Descrição |
|---|---|
S_OK |
A função interrompeu com êxito a gravação. |
E_INVALIDARG |
Um ou mais argumentos são inválidos. |
E_WPRC_FAILED_TO_STOP_PROFILE |
Falha na biblioteca ao interromper um perfil na coleção de perfis. Use IControlErrorInfo para obter informações detalhadas de erro. |
E_WPRC_TRACE_MERGE_LOST_EVENTS |
A sessão ETW (Rastreamento de Eventos para Windows) perdeu eventos e mesclar os arquivos etl (log de rastreamento de eventos) da sessão pode criar um arquivo ETL incompleto. |
Comentários
Use essa função somente para perfis que estão registrando em log sequencialmente em um arquivo. Depois que as sessões forem salvas, a gravação será interrompida.