Метод IPersistSerializedPropStorage::SetFlags (propsys.h)

Статья
08/25/2023

Переключает объект хранилища свойств между состоянием только для чтения и чтения и записи.

Синтаксис

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

Параметры

[in] flags

Тип: PERSIST_SPROPSTORE_FLAGS

Параметр flags принимает одно из следующих значений, чтобы задать параметры поведения хранилища свойств:

FPSPS_DEFAULT (0x00000000)

Windows 7 и более поздние версии. Объект хранилища свойств доступен для чтения и записи.

FPSPS_READONLY (0x00000001)

Объект хранилища свойств доступен только для чтения.

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

Представлено в Windows 8. Новые значения свойств, добавляемые в хранилище свойств с помощью метода IPropertyStore::SetValue , приведут к тому, что метод IPersistStream::IsDirty вернет S_OK. Если этот флаг не задан, добавление новых значений свойств в хранилище свойств не влияет на значение, возвращаемое IPersistStream::IsDirty.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Чтение и запись — это параметр по умолчанию. IPersistSerializedPropStorage::SetFlags можно вызвать в любое время для переключения состояния только для чтения и чтения и записи хранилища свойств.

В версиях Windows до Windows 7 вызывающие абоненты могут назначать нулевое литеральное значение непосредственно в параметре flags , чтобы задать состояние чтения и записи. В Windows 7 вместо него следует использовать значение флага FPSPS_DEFAULT.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	propsys.h

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