Fonction SHBindToFolderIDListParent (shlobj_core.h)

É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

Configuration requise

Voir aussi

SHBindToFolderIDListParentEx