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


Stop

Останавливает запись в режиме ведения журнала файлов.

Синтаксис

HRESULT Stop
  ([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_STOP_PROFILE

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

E_WPRC_TRACE_MERGE_LOST_EVENTS

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

Комментарии

Используйте эту функцию только для профилей, которые последовательно записываются в файл. После сохранения сеансов запись останавливается.

IControlManager