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