Salvar

Salva uma gravação registrada em buffers circulares na memória no arquivo ETL (log de rastreamento de eventos) especificado. A gravação continua em execução.

Sintaxe

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

Parâmetros

bstrFileName
[in] O nome do arquivo no qual eventos mesclados de gravações de todos os perfis são salvos.

pProfileCollection
[in] Um ponteiro para o objeto IProfileCollection que contém uma coleção de perfis a serem salvos.

pTraceMergeProperties
[in] Um ponteiro para o 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 salvou com êxito a gravação.
E_INVALIDARG	Um ou mais argumentos são inválidos.
E_WPRC_FAILED_TO_SAVE_PROFILE	Falha na biblioteca ao salvar 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

Essa função é usada apenas para perfis que estão registrando em log em buffers circulares. Depois que as sessões são salvas, a gravação continua a ser executada.

Tópicos relacionados

IControlManager