Freigeben über


PSGetPropertySystem-Funktion (propsys.h)

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