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

Article
03/04/2024

Lie à un gestionnaire pour un élément tel que spécifié par la valeur d’ID de gestionnaire (BHID).

Syntaxe

HRESULT BindToHandler(
  IBindCtx *pbc,
  REFGUID  bhid,
  REFIID   riid,
  void     **ppv
);

Paramètres

pbc

Type : IBindCtx*

Pointeur vers une interface IBindCtx sur un objet de contexte de liaison. Permet de passer des paramètres facultatifs au gestionnaire. Le contenu du contexte de liaison est spécifique au gestionnaire. Par exemple, lors de la liaison à BHID_Stream, les indicateurs STGM dans le contexte de liaison indiquent le mode d’accès souhaité (lecture ou lecture/écriture).

bhid

Type : REFGUID

Référence à un GUID qui spécifie le gestionnaire à créer. L’une des valeurs suivantes définies dans Shlguid.h :

BHID_SFObject

Limite l’utilisation à BindToObject.

BHID_SFUIObject

Limite l’utilisation à GetUIObjectOf.

BHID_SFViewObject

Limite l’utilisation à CreateViewObject.

BHID_Storage

Tente de récupérer le RIID de stockage, mais utilise par défaut l’implémentation shell en cas d’échec.

BHID_Stream

Limite l’utilisation à IStream.

BHID_LinkTargetItem

CLSID_ShellItem est initialisé avec la cible de cet élément (peut uniquement être SFGAO_LINK). Consultez SFGAO pour obtenir une description de SFGAO_LINK.

BHID_StorageEnum

Si l’élément est un dossier, obtient un objet IEnumShellItems avec lequel énumérer le contenu du stockage.

BHID_Transfer

Introduit dans Windows Vista : si l’élément est un dossier, obtient un objet ITransferSource ou ITransferDestination .

BHID_PropertyStore

Introduit dans Windows Vista : limite l’utilisation à IPropertyStore ou IPropertyStoreFactory.

BHID_ThumbnailHandler

Introduit dans Windows Vista : limite l’utilisation à IExtractImage ou IThumbnailProvider.

BHID_EnumItems

Introduit dans Windows Vista : si l’élément est un dossier, obtient un objet IEnumShellItems qui énumère tous les éléments du dossier. Cela inclut les dossiers, les non-dossiers et les éléments masqués.

BHID_DataObject

Introduit dans Windows Vista : obtient un objet IDataObject à utiliser avec un élément ou un tableau d’éléments.

BHID_AssociationArray

Introduit dans Windows Vista : obtient un objet IQueryAssociations à utiliser avec un élément ou un tableau d’éléments.

BHID_Filter

Introduit dans Windows Vista : limite l’utilisation à IFilter.

BHID_EnumAssocHandlers

Introduit dans Windows 7 : obtient un objet IEnumAssocHandlers utilisé pour énumérer les gestionnaires d’association recommandés pour l’élément donné.

BHID_RandomAccessStream

Introduit dans Windows 8 : obtient un objet IRandomAccessStream pour l’élément.

BHID_FilePlaceholder

Introduit dans Windows 8.1 : obtient un objet utilisé pour fournir des fonctionnalités de fichier d’espace réservé.

riid

Type : REFIID

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

ppv

Type : void**

Lorsque cette méthode est retournée, contient un pointeur de type riid 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 XP avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 5.00 ou ultérieure)

Voir aussi

IShellFolder

IShellItem

Partager via