Fonction SHBindToObject (shlobj_core.h)

Récupère et lie à un objet spécifié à l’aide de la méthode IShellFolder :BindToObject de l’espace de noms Shell.

Syntaxe

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

Paramètres

psf

Type : IShellFolder*

Pointeur vers IShellFolder. Ce paramètre peut être NULL. Si psf a la valeur NULL, cela indique que le paramètre pidl est relatif au bureau. Dans ce cas, pidl doit spécifier un ITEMIDLIST absolu.

pidl

Type : PCUIDLIST_RELATIVE

Pointeur vers un ITEMIDLIST constant à lier à qui est relatif à psf. Si psf a la valeur NULL, il s’agit d’un ITEMIDLIST absolu par rapport au dossier de bureau.

[in] pbc

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. É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.

riid

Type : REFIID

Identificateur de l’interface à retourner.

[out] ppv

Type : void**

Lorsque cette méthode retourne, contient le pointeur d’interface comme spécifié dans riid vers l’objet lié. Si une erreur se produit, contient un pointeur 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

IShellFolder

IShellFolder ::BindToObject