Méthode IShellItemArray ::BindToHandler (shobjidl_core.h)

Article
03/04/2024

Lie à un objet au moyen du gestionnaire spécifié.

Syntaxe

HRESULT BindToHandler(
  [in]  IBindCtx *pbc,
  [in]  REFGUID  bhid,
  [in]  REFIID   riid,
  [out] void     **ppvOut
);

Paramètres

[in] pbc

Type : IBindCtx*

Pointeur vers une interface IBindCtx sur un objet de contexte de liaison.

[in] bhid

Type : REFGUID

L’une des valeurs suivantes, définies dans Shlguid.h, qui déterminent le gestionnaire.

BHID_SFUIObject

Limite l’utilisation à GetUIObjectOf. Utilisez ce type de gestionnaire uniquement pour un tableau d’éléments plats, où tous les éléments se trouvent dans le même dossier.

BHID_DataObject

Introduit dans Windows Vista : obtient un objet IDataObject à utiliser avec un élément ou un tableau d’éléments. Utilisez ce type de gestionnaire uniquement pour les objets de données plats ou les tableaux d’éléments créés par SHCreateShellItemArrayFromDataObject.

BHID_AssociationArray

Introduit dans Windows Vista : obtient un objet IQueryAssociations à utiliser avec un élément ou un tableau d’éléments. Cela récupère uniquement l’objet de tableau d’association pour le premier élément dans IShellItemArray

[in] riid

Type : REFIID

IID du type d’objet à récupérer.

[out] ppvOut

Type : void**

Lorsque cette méthode retourne, contient l’objet spécifié dans riid qui est retourné par le gestionnaire spécifié par rbhid.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)

Share via