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

Alterna el objeto de almacén de propiedades entre el estado de solo lectura y lectura y escritura.

Sintaxis

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

Parámetros

[in] flags

Tipo: PERSIST_SPROPSTORE_FLAGS

El parámetro flags toma uno de los valores siguientes para establecer opciones para el comportamiento del almacenamiento de propiedades:

FPSPS_DEFAULT (0x00000000)

Windows 7 y versiones posteriores. El objeto de almacén de propiedades es de lectura y escritura.

FPSPS_READONLY (0x00000001)

El objeto de almacén de propiedades es de solo lectura.

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

Introducido en Windows 8. Los nuevos valores de propiedad que se agregan al almacén de propiedades a través del método IPropertyStore::SetValue harán que el método IPersistStream::IsDirty devuelva S_OK. Si no se establece esta marca, la adición de nuevos valores de propiedad al almacén de propiedades no afecta al valor devuelto por IPersistStream::IsDirty.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Lectura y escritura es la configuración predeterminada. Se puede llamar a IPersistSerializedPropStorage::SetFlags en cualquier momento para alternar el estado de solo lectura y lectura y escritura del almacén de propiedades.

En versiones de Windows anteriores a Windows 7, los autores de llamadas pueden asignar un valor cero literal directamente al parámetro flags para establecer el estado de lectura y escritura. A partir de Windows 7, se debe usar el valor de marca FPSPS_DEFAULT en su lugar.

Requisitos