Condividi tramite

Stop

  • Articolo

Arresta una registrazione in modalità di registrazione file.

Sintassi

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

Parametri

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

pProfileCollection
[in] Puntatore a un oggetto IProfileCollection contenente una raccolta di profili da salvare.

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

Valore restituito

La tabella seguente descrive i valori restituiti possibili.

Valore restituito Descrizione

S_OK

La funzione ha arrestato correttamente la registrazione.

E_INVALIDARG

Uno o più argomenti non sono validi.

E_WPRC_FAILED_TO_STOP_PROFILE

La libreria non è riuscita a arrestare un profilo nella raccolta di profili. Usare IControlErrorInfo per ottenere informazioni dettagliate sugli errori.

E_WPRC_TRACE_MERGE_LOST_EVENTS

La sessione ETW (Event Trace for Windows) perde eventi e l'unione dei file ETL (Event Trace Log) dalla sessione può creare un file ETL incompleto.

Commenti

Usare questa funzione solo per i profili che registrano in sequenza un file. Dopo il salvataggio delle sessioni, la registrazione si arresta.

IControlManager