Condividi tramite

Salva

  • Articolo

Salva una registrazione registrata in buffer circolari in memoria nel file ETL (Event Trace Log) specificato. La registrazione continua a essere eseguita.

Sintassi

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

Parametri

Bstrfilename
[in] Nome del file in cui vengono salvati gli eventi uniti dalle registrazioni di tutti i profili.

pProfileCollection
[in] Puntatore all'oggetto IProfileCollection che contiene un insieme di profili da salvare.

pTraceMergeProperties
[in] Puntatore all'oggetto ITraceMergeProperties contenente le proprietà con cui unire le registrazioni.

Valore restituito

Nella tabella seguente vengono descritti i possibili valori restituiti.

Valore restituito Descrizione

S_OK

La funzione ha salvato correttamente la registrazione.

E_INVALIDARG

Uno o più argomenti non sono validi.

E_WPRC_FAILED_TO_SAVE_PROFILE

Impossibile salvare un profilo nella raccolta di profili. Usare IControlErrorInfo per ottenere informazioni dettagliate sull'errore.

E_WPRC_TRACE_MERGE_LOST_EVENTS

Gli eventi persi della sessione ETW (Event Tracing for Windows) e l'unione dei file del registro eventi (ETL) dalla sessione può creare un file ETL incompleto.

Commenti

Questa funzione viene usata solo per i profili che eseguono la registrazione in buffer circolari. Dopo il salvataggio delle sessioni, la registrazione continua a essere eseguita.

IControlManager