IPropertyStoreFactory::GetPropertyStore-Methode (propsys.h)

Artikel
03/01/2024

Ruft ein IPropertyStore-Objekt ab, das den angegebenen Flags entspricht.

Syntax

HRESULT GetPropertyStore(
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  IUnknown              *pUnkFactory,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Parameter

[in] flags

Typ: GETPROPERTYSTOREFLAGS

GETPROPERTYSTOREFLAGS-Werte , die den zurückgegebenen Speicher ändern.

[in] pUnkFactory

Typ: IUnknown*

Optional. Ein Zeiger auf das IUnknown eines Objekts, das ICreateObject implementiert. Wenn pUnkFactory bereitgestellt wird, kann diese Methode den Handler instance mithilfe von ICreateObject anstelle von CoCreateInstance erstellen, falls implementiert. Der Grund für die Bereitstellung von pUnkFactory besteht in der Regel darin, den Handler in einem anderen Prozess zu erstellen. Für die meisten Benutzer ist es jedoch ausreichend, NULL in diesem Parameter zu übergeben.

[in] riid

Typ: REFIID

Ein Verweis auf IID des zu erstellenden Objekts.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält die Adresse eines IPropertyStore-Schnittstellenzeigers .

Rückgabewert

Typ: HRESULT

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

Hinweise

Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in Objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers ausgeschlossen wird.

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