Fonction PSGetPropertyDescriptionListFromString (propsys.h)

Obtient une instance d’une interface de liste de description de propriétés pour une liste de propriétés spécifiée.

Syntaxe

PSSTDAPI PSGetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

Paramètres

[in] pszPropList

Type : LPCWSTR

Pointeur vers une chaîne Unicode terminée par null qui identifie la liste de propriétés. Pour plus d’informations sur le format de ce paramètre, consultez IPropertySystem ::GetPropertyDescriptionListFromString .

[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 de IPropertyDescriptionList.

Valeur retournée

Type : PSSTDAPI

Retourne l’une des valeurs suivantes.

Remarques

Cette fonction appelle l’implémentation du sous-système de propriété de IPropertySystem ::GetPropertyDescriptionListFromString pour obtenir une collection de propriétés fournies sous forme de chaîne de liste de propriétés délimitées par des points-virgules.

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.

Pour plus d’informations sur les schémas de propriétés, consultez Schémas de propriété.

Exemples

L’exemple suivant, à inclure dans un programme plus grand, montre comment utiliser PSGetPropertyDescriptionListFromString.

IPropertyDescriptionList *pList;

HRESULT hr = PSGetPropertyDescriptionListFromString(L"prop:System.Title;System.Size",
                                                    IID_PPV_ARGS(&pList));
                                                    
if (SUCCEEDED(hr))
{
    // pList is now valid.
 
    pList->Release();
}

Configuration requise