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

Article
08/08/2024

Bascule l’objet du magasin de propriétés entre l’état en lecture seule et en lecture/écriture.

Syntaxe

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

Paramètres

[in] flags

Type : PERSIST_SPROPSTORE_FLAGS

Le paramètre flags prend l’une des valeurs suivantes pour définir des options pour le comportement du stockage de propriétés :

FPSPS_DEFAULT (0x00000000)

Windows 7 et versions ultérieures. L’objet de magasin de propriétés est en lecture/écriture.

FPSPS_READONLY (0x00000001)

L’objet de magasin de propriétés est en lecture seule.

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

Introduit dans Windows 8. Les nouvelles valeurs de propriété ajoutées au magasin de propriétés par le biais de la méthode IPropertyStore ::SetValue entraînent le retour de la méthode IPersistStream ::IsDirty S_OK. Si cet indicateur n’est pas défini, l’ajout de nouvelles valeurs de propriété au magasin de propriétés n’affecte pas la valeur retournée par IPersistStream ::IsDirty.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La lecture/écriture est le paramètre par défaut. IPersistSerializedPropStorage ::SetFlags peut être appelé à tout moment pour basculer l’état en lecture seule et en lecture/écriture du magasin de propriétés.

Dans les versions de Windows antérieures à Windows 7, les appelants peuvent affecter une valeur littérale zéro directement dans le paramètre flags pour définir l’état de lecture/écriture. À partir de Windows 7, la valeur de l’indicateur FPSPS_DEFAULT doit être utilisée à la place.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h

Partager via