Метод IPropertyStore::Commit (propsys.h)

  • Статья

После внесения изменений этот метод сохраняет изменения.

Синтаксис

HRESULT Commit();

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

Метод IPropertyStore::Commit возвращает любой из следующих элементов:

Код возврата Описание
S_OK
 Все изменения свойств были успешно записаны в поток или путь. Сюда входит случай, когда при вызове метода изменения не ожидались и ничего не было записано.
STG_E_ACCESSDENIED
 Поток или файл доступен только для чтения; методу не удалось задать значение .
E_FAIL
 Не удалось записать некоторые или все изменения в файл. Вместо E_FAIL можно использовать другую, более объяснительную ошибку.

Комментарии

Перед возвратом Commit метода он освобождает файловый поток или путь, который был инициализирован для использования методом . Таким образом, методы IPropertyStore не завершатся успешно после Commit возврата. В этот момент они возвращают E_FAIL.

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

Требования

   
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционной системы Windows.
Целевая платформа Универсальное
Верхняя часть propsys.h
Библиотека Propsys.idl
IRQL Все уровни

См. также раздел

IPropertyStore