Fonction PSGetImageReferenceForValue (propsys.h)

Article
03/04/2024

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

Syntaxe

PSSTDAPI PSGetImageReferenceForValue(
  [in]  REFPROPERTYKEY propkey,
  [in]  REFPROPVARIANT propvar,
  [out] PWSTR          *ppszImageRes
);

Paramètres

[in] propkey

Type : REFPROPERTYKEY

Référence à une structure PROPERTYKEY qui spécifie la propriété.

[in] propvar

Type : REFIID

Référence à l’IID de l’interface à récupérer via ppv.

[out] ppszImageRes

Type : void**

Lorsque cette fonction retourne correctement, contient le pointeur d’interface demandé dans riid.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire, y compris les éléments suivants :

Code de retour	Description
TYPE_E_ELEMENTNOTFOUND

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 dans riid qui pourrait entraîner des résultats inattendus.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h (include Propsys.idl)
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 6.0 ou ultérieure)

Partager via