Metodo IPersistSerializedPropStorage::SetFlags (propsys.h)

Articolo
03/01/2024

Attiva o disattiva l'oggetto archivio proprietà tra lo stato di sola lettura e di lettura/scrittura.

Sintassi

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

Parametri

[in] flags

Tipo: PERSIST_SPROPSTORE_FLAGS

Il parametro flags accetta uno dei valori seguenti per impostare le opzioni per il comportamento dell'archiviazione delle proprietà:

FPSPS_DEFAULT (0x00000000)

Windows 7 e versioni successive. L'oggetto archivio proprietà è di lettura/scrittura.

FPSPS_READONLY (0x00000001)

L'oggetto archivio proprietà è di sola lettura.

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

Introdotto in Windows 8. I nuovi valori di proprietà aggiunti all'archivio delle proprietà tramite il metodo IPropertyStore::SetValue causeranno la restituzione del metodo IPersistStream::IsDirty S_OK. Se questo flag non è impostato, l'aggiunta di nuovi valori di proprietà all'archivio delle proprietà non influisce sul valore restituito da IPersistStream::IsDirty.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Lettura/scrittura è l'impostazione predefinita. IPersistSerializedPropStorage::SetFlags può essere chiamato in qualsiasi momento per attivare o disattivare lo stato di sola lettura e di lettura/scrittura dell'archivio proprietà.

Nelle versioni di Windows precedenti a Windows 7, i chiamanti possono assegnare un valore letterale zero direttamente nel parametro flags per impostare lo stato di lettura/scrittura. A partire da Windows 7, è necessario usare invece il valore del flag FPSPS_DEFAULT.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h

Condividi tramite