Fonction SHBindToFolderIDListParentEx (shlobj_core.h)

Article
03/02/2024

Étend la fonction SHBindToFolderIDListParent en autorisant l’appelant à spécifier un contexte de liaison.

Syntaxe

SHSTDAPI SHBindToFolderIDListParentEx(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in, optional]  IBindCtx           *ppbc,
  [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’une IDList absolue relative au dossier de bureau.

[in, optional] ppbc

Type : IBindCtx*

Pointeur vers l’interface IBindCtx sur un objet de contexte de liaison à utiliser pendant cette opération. Si ce paramètre n’est pas utilisé, définissez-le sur NULL, ce qui équivaut à appeler la fonction SHBindToFolderIDListParent . Étant donné que la prise en charge de pbc est facultative pour les implémentations d’objets de dossier, certains dossiers peuvent ne pas prendre en charge l’utilisation de contextes de liaison.

[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 d’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.

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

Voir aussi

SHBindToFolderIDListParent

Partager via