SHBindToFolderIDListParentEx, fonction (shlobj_core.h)

É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’un IDList absolu relatif 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é. Cela est généralement IID_IShellFolder ou IID_IShellFolder2, mais peut être tout ce qui est pris en charge par le dossier cible.

[out] ppv

Type : void**

Lorsque cette fonction est retournée, 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 par rapport 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

Voir aussi

SHBindToFolderIDListParent