Método IPersistSerializedPropStorage::SetFlags (propsys.h)

Alterna o objeto de repositório de propriedades entre o estado somente leitura e leitura/gravação.

Sintaxe

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

Parâmetros

[in] flags

Tipo: PERSIST_SPROPSTORE_FLAGS

O parâmetro flags usa um dos seguintes valores para definir opções para o comportamento do armazenamento de propriedades:

FPSPS_DEFAULT (0x00000000)

Windows 7 e posterior. O objeto do repositório de propriedades é de leitura/gravação.

FPSPS_READONLY (0x00000001)

O objeto do repositório de propriedades é somente leitura.

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

Introduzido no Windows 8. Novos valores de propriedade adicionados ao repositório de propriedades por meio do método IPropertyStore::SetValue farão com que o método IPersistStream::IsDirty retorne S_OK. Se esse sinalizador não estiver definido, a adição de novos valores de propriedade ao repositório de propriedades não afetará o valor retornado por IPersistStream::IsDirty.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Leitura/gravação é a configuração padrão. IPersistSerializedPropStorage::SetFlags pode ser chamado a qualquer momento para alternar o estado somente leitura e leitura/gravação do repositório de propriedades.

Em versões do Windows antes do Windows 7, os chamadores podem atribuir um valor zero literal diretamente ao parâmetro flags para definir o estado de leitura/gravação. A partir do Windows 7, o valor do sinalizador FPSPS_DEFAULT deve ser usado.

Requisitos