PSGetPropertyDescription-Funktion (propsys.h)

Ruft eine instance einer Eigenschaftenbeschreibungsschnittstelle für eine Eigenschaft ab, die von einer PROPERTYKEY-Struktur angegeben wird.

Syntax

PSSTDAPI PSGetPropertyDescription(
  [in]  REFPROPERTYKEY propkey,
  [in]  REFIID         riid,
  [out] void           **ppv
);

Parameter

[in] propkey

Typ: REFPROPERTYKEY

Verweis auf einen PROPERTYKEY.

[in] riid

Typ: REFIID

Verweis auf die Schnittstellen-ID der angeforderten Schnittstelle.

[out] ppv

Typ: void**

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

Rückgabewert

Typ: PSSTDAPI

Gibt einen der folgenden Werte zurück.

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.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie PSGetPropertyDescription verwendet wird, um die Eigenschaftenbeschreibung für die Bewertungseigenschaft abzurufen.

IPropertyDescription *pPropDesc;

HRESULT hr = PSGetPropertyDescription(PKEY_Ratings, IID_PPV_ARGS(&pPropDesc));

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

Anforderungen

Weitere Informationen

PSGetPropertyDescriptionByName

PSGetPropertySystem