PSGetPropertySystem-Funktion (propsys.h)

Artikel
08/25/2023

Ruft eine instance des Subsystemobjekts ab, das IPropertySystem implementiert.

Syntax

PSSTDAPI PSGetPropertySystem(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] riid

Typ: REFIID

Verweis auf die IID der angeforderten Schnittstelle.

[out] ppv

Typ: void**

Wenn diese Funktion zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IPropertySystem.

Rückgabewert

Typ: PSSTDAPI

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Die -Schnittstelle wurde abgerufen.
E_INVALIDARG	Der ppv-Parameter ist NULL.

Hinweise

Sie müssen das Component Object Model (COM) mit CoInitialize oder OleInitialize initialisieren, bevor Sie PSGetPropertySystem aufrufen. COM muss für die Lebensdauer dieses Objekts initialisiert bleiben. Das Eigenschaftensystemobjekt aggregiert den Freethread-Marshaller und ist threadsicher.

Es wird empfohlen, das in Objbase.h definierte makro IID_PPV_ARGS zu verwenden, 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.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms enthalten sein soll, wird die Verwendung von PSGetPropertySystem veranschaulicht.

IPropertySystem *pSystem;

HRESULT hr = PSGetPropertySystem(IID_PPV_ARGS(&pSystem));

if (SUCCEEDED(hr))
{
    // pSystem is now valid.
 
    pSystem->Release();
}

Anforderungen


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