Stop

Beendet eine Aufzeichnung im Dateiprotokollierungsmodus.

Syntax

HRESULT Stop
  ([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 Auflistung von Profilen enthält, die gestartet 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 beendet.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_WPRC_FAILED_TO_STOP_PROFILE	Die Bibliothek konnte ein Profil in der Profilsammlung nicht beenden. Verwenden Sie IControlErrorInfo, um detaillierte Fehlerinformationen abzurufen.
E_WPRC_TRACE_MERGE_LOST_EVENTS	Die Ereignisablaufverfolgungssitzung für Windows hat Ereignisse verloren, und das Zusammenführen der Ereignisablaufverfolgungsprotokolldateien (ETL) aus der Sitzung kann zu einer unvollständigen ETL-Datei führen.

Bemerkungen

Verwenden Sie diese Funktion nur für Profile, die sequenziell in einer Datei protokolliert werden. Nachdem die Sitzungen gespeichert wurden, wird die Aufzeichnung beendet.

Zugehörige Themen

IControlManager