Fonction PSGetPropertyDescription (propsys.h)

Obtient une instance d’une interface de description de propriété pour une propriété spécifiée par une structure PROPERTYKEY.

Syntaxe

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

Paramètres

[in] propkey

Type : REFPROPERTYKEY

Référence à un PROPERTYKEY.

[in] riid

Type : REFIID

Référence à l’ID d’interface de l’interface demandée.

[out] ppv

Type : void**

Lorsque cette fonction retourne, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IPropertyDescription, IPropertyDescriptionAliasInfo ou IPropertyDescriptionSearchInfo.

Valeur retournée

Type : PSSTDAPI

Retourne l’une des valeurs suivantes.

Remarques

Nous vous recommandons d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée vers la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage.

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus grand, montre comment utiliser PSGetPropertyDescription pour obtenir la description de la propriété ratings.

IPropertyDescription *pPropDesc;

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

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

Configuration requise

Voir aussi

PSGetPropertyDescriptionByName

PSGetPropertySystem