Fonction PSGetPropertyDescriptionListFromString (propsys.h)

Article
03/01/2024

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.

Code de retour	Description
S_OK	L’interface a été obtenue.
E_INVALIDARG	Le paramètre ppv est NULL.

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

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 5.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Partager via