Поделиться через


Сохранить

Сохраняет запись, записанную в циклические буферы в памяти, в указанный файл журнала трассировки событий (ETL). Запись продолжает выполняться.

Синтаксис

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

Параметры

bstrFileName
[in] Имя файла, в который сохраняются объединенные события из записей всех профилей.

pProfileCollection
[in] Указатель на объект IProfileCollection , содержащий коллекцию профилей для сохранения.

pTraceMergeProperties
[in] Указатель на объект ITraceMergeProperties , содержащий свойства для объединения записей.

Возвращаемое значение

В следующей таблице описаны возможные возвращаемые значения.

Возвращаемое значение Описание:

S_OK

Функция успешно сохранила запись.

E_INVALIDARG

Один или несколько аргументов недопустимы.

E_WPRC_FAILED_TO_SAVE_PROFILE

Библиотеке не удалось сохранить профиль в коллекции профилей. Используйте IControlErrorInfo для получения подробных сведений об ошибке.

E_WPRC_TRACE_MERGE_LOST_EVENTS

В сеансе трассировки событий Windows (ETW) потеряны события, а слияние файлов журнала трассировки событий (ETL) из сеанса может создать неполный ETL-файл.

Комментарии

Эта функция используется только для профилей, которые регистрируются в циклических буферах. После сохранения сеансов запись продолжает выполняться.

IControlManager