Speichern

Speichert eine Aufzeichnung, die an Zirkelpuffern im Arbeitsspeicher protokolliert wird, in der angegebenen Ereignisablaufverfolgungsprotokolldatei (ETL). Die Aufzeichnung wird weiterhin ausgeführt.

Syntax

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

Parameter

bstrFileName
[in]: Der Name der Datei, in der zusammengeführte Ereignisse aus Aufzeichnungen aller Profile gespeichert werden.

pProfileCollection
[in] Ein Zeiger auf ein IProfileCollection-Objekt, das eine Sammlung von Profilen enthält, die gespeichert werden sollen.

pTraceMergeProperties
[in] Ein Zeiger auf das ITraceMergeProperties-Objekt , das Eigenschaften enthält, mit denen Aufzeichnungen zusammengeführt werden sollen.

Rückgabewert

In der folgenden Tabelle sind die möglichen Rückgabewerte beschrieben.

Rückgabewert	BESCHREIBUNG
S_OK	Die Funktion hat die Aufzeichnung erfolgreich gespeichert.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_WPRC_FAILED_TO_SAVE_PROFILE	Die Bibliothek konnte ein Profil in der Profilsammlung nicht speichern. Verwenden Sie IControlErrorInfo , um detaillierte Fehlerinformationen abzurufen.
E_WPRC_TRACE_MERGE_LOST_EVENTS	Die Ereignisablaufverfolgung für Windows (ETW)-Sitzung verlorene Ereignisse und das Zusammenführen der Ereignisablaufverfolgungsprotokolldateien (ETL) aus der Sitzung kann eine unvollständige ETL-Datei erstellen.

Bemerkungen

Diese Funktion wird nur für Profile verwendet, die sich bei Zirkelpuffern anmelden. Nachdem die Sitzungen gespeichert wurden, wird die Aufzeichnung weiterhin ausgeführt.

Zugehörige Themen

IControlManager