Fonction SHBindToFolderIDListParent (shlobj_core.h)

Article
03/02/2024

Étant donné un élément d’espace de noms Shell spécifié sous la forme d’un dossier et une liste d’identificateurs d’élément relative à ce dossier, cette fonction est liée au parent de l’élément d’espace de noms et retourne éventuellement un pointeur vers le composant final de la liste d’identificateurs d’élément.

Syntaxe

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in]            REFIID             riid,
  [out]           void               **ppv,
  [out, optional] PCUITEMID_CHILD    *ppidlLast
);

Paramètres

[in, optional] psfRoot

Type : IShellFolder*

Pointeur vers un objet de dossier Shell. Si psfRoot a la valeur NULL, indique que l’IDList passé est relatif au bureau.

[in] pidl

Type : PCUIDLIST_RELATIVE

PIDL à lier, par rapport à psfRoot. Si psfRoot a la valeur NULL, il s’agit d’un IDList absolu relatif au dossier de bureau.

[in] riid

Type : REFIID

Référence à l’ID d’interface souhaité. Il s’agit généralement IID_IShellFolder ou IID_IShellFolder2, mais peut être pris en charge par le dossier cible.

[out] ppv

Type : void**

Lorsque cette fonction retourne, contient le pointeur d’interface demandé dans riid. Il s’agit généralement de IShellFolder ou IShellFolder2, mais peut être pris en charge par le dossier cible.

[out, optional] ppidlLast

Type : PCUITEMID_CHILD*

Pointeur vers le dernier ID du paramètre pidl et est un ID enfant relatif au dossier parent retourné dans ppv. Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

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

Remarques

Note Appeler la fonction SHBindToFolderIDListParent revient à appeler la fonction SHBindToFolderIDListParentEx avec NULL comme contexte de liaison.

Configuration requise

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	shlobj_core.h (inclure Shlobj.h)
DLL	Shell32.dll

Voir aussi

SHBindToFolderIDListParentEx

Partager via