Partager via

Fonction SHBindToParent (shlobj_core.h)

  • Article

Prend un pointeur vers une liste d’identificateurs d’élément complet (PIDL) et retourne un pointeur d’interface spécifié sur l’objet parent.

Syntaxe

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

Paramètres

[in] pidl

Type : PCIDLIST_ABSOLUTE

PIDL de l’élément.

[in] riid

Type : REFIID

REFIID de l’une des interfaces exposées par l’objet parent de l’élément.

[out] ppv

Type : VOID**

Pointeur vers l’interface spécifiée par riid. Vous devez libérer l’objet lorsque vous avez terminé.

[out] ppidlLast

Type : PCUITEMID_CHILD*

PIDL de l’élément par rapport au dossier parent. Ce PIDL peut être utilisé avec de nombreuses méthodes prises en charge par les interfaces du dossier parent. Si vous définissez ppidlLast sur NULL, le PIDL n’est pas retourné.

RemarqueSHBindToParent n’alloue pas de nouveau PIDL ; il reçoit simplement un pointeur via ce paramètre. Par conséquent, vous n’êtes pas responsable de la libération de cette ressource.
 

Valeur retournée

Type : HRESULT

Si cette fonction 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 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h (inclure Shlobj.h)
Bibliothèque Shell32.lib
DLL Shell32.dll (version 5.0 ou ultérieure)