PSCreatePropertyStoreFromPropertySetStorage-Funktion (propsys.h)

Artikel
03/01/2024

Umschließt eine IPropertySetStorage-Schnittstelle in einer IPropertyStore-Schnittstelle .

Syntax

PSSTDAPI PSCreatePropertyStoreFromPropertySetStorage(
  [in]  IPropertySetStorage *ppss,
  [in]  DWORD               grfMode,
  [in]  REFIID              riid,
  [out] void                **ppv
);

Parameter

[in] ppss

Typ: IPropertySetStorage*

Ein Zeiger auf eine IPropertySetStorage-Schnittstelle .

[in] grfMode

Art: DWORD

Gibt den zu erzwingenden Zugriffsmodus an. grfMode sollte mit dem Zugriffsmodus übereinstimmen, der zum Öffnen von IPropertySetStorage verwendet wird. Gültige Werte sind:

STGM_READ

Aufrufe von IPropertyStore::SetValue aktualisieren einen internen Cache von Eigenschaften, und Aufrufe von IPropertyStore::Commit rufen die entsprechenden IPropertySetStorage-Methoden auf, um die geänderten Eigenschaften zu schreiben.

STGM_WRITE

Wird nicht unterstützt.

STGM_READWRITE

Wird nicht unterstützt.

[in] riid

Typ: REFIID

Verweis auf eine IID.

[out] ppv

Typ: void**

Wenn diese Funktion zurückgibt, enthält den in riid angegebenen Schnittstellenzeiger.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion umschließt eine IPropertySetStorage-Schnittstelle in einer IPropertyStore-Schnittstelle . Jeder andere Wert als STGM_READ für grfMode führt dazu, dass Aufrufe von IPropertyStore::SetValue und IPropertyStore::Commit mit STG_E_ACCESSDENIED fehlschlagen .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propsys.h
Bibliothek	Propsys.lib
DLL	Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über