IPersistSerializedPropStorage::SetFlags-Methode (propsys.h)

Artikel
03/04/2024

Schaltet das Eigenschaftsspeicherobjekt zwischen dem schreibgeschützten und dem Lese-/Schreibzustand um.

Syntax

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

Parameter

[in] flags

Typ: PERSIST_SPROPSTORE_FLAGS

Der Flags-Parameter verwendet einen der folgenden Werte, um Optionen für das Verhalten des Eigenschaftenspeichers festzulegen:

FPSPS_DEFAULT (0x00000000)

Windows 7 und höher. Das Eigenschaftenspeicherobjekt ist Lese-/Schreibzugriff.

FPSPS_READONLY (0x00000001)

Das Eigenschaftenspeicherobjekt ist schreibgeschützt.

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

In Windows 8 eingeführt. Neue Eigenschaftswerte, die dem Eigenschaftenspeicher über die IPropertyStore::SetValue-Methode hinzugefügt werden, führen dazu, dass die IPersistStream::IsDirty-Methode S_OK zurückgibt. Wenn dieses Flag nicht festgelegt ist, wirkt sich das Hinzufügen neuer Eigenschaftswerte zum Eigenschaftenspeicher nicht auf den von IPersistStream::IsDirty zurückgegebenen Wert aus.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Lese-/Schreibzugriff ist die Standardeinstellung. IPersistSerializedPropStorage::SetFlags kann jederzeit aufgerufen werden, um den Schreibschutz- und Lese-/Schreibzustand des Eigenschaftenspeichers umzuschalten.

In Versionen von Windows vor Windows 7 können Aufrufer dem Flags-Parameter direkt einen Literalwert zuweisen, um den Lese-/Schreibzustand festzulegen. Ab Windows 7 sollte stattdessen der FPSPS_DEFAULT-Flagwert verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propsys.h

Freigeben über