Méthode IShellFolder::BindToStorage (shobjidl_core.h)

Demande un pointeur vers l’interface de stockage d’un objet.

Syntaxe

HRESULT BindToStorage(
  [in]  PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
  [in]  REFIID             riid,
  [out] void               **ppv
);

Paramètres

[in] pidl

Type : PCUIDLIST_RELATIVE

Adresse d’une structure ITEMIDLIST qui identifie le sous-dossier relatif à son dossier parent. La structure doit contenir exactement une structure SHITEMID suivie d’un zéro de fin.

[in] pbc

Type : IBindCtx*

Adresse facultative d’une 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.

[in] riid

Type : REFIID

IID de l’interface de stockage demandée. Pour récupérer un pointeur d’interface IStream, IStorage ou IPropertySetStorage , définissez riid sur IID_IStream, IID_IStorage ou IID_IPropertySetStorage, respectivement.

[out] ppv

Type : void**

Adresse qui reçoit le pointeur d’interface spécifié par riid. Si une erreur se produit, un pointeur NULL est retourné dans cette adresse.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les extensions d’espace de noms ont la possibilité d’autoriser les applications à se lier à un objet qui représente le stockage d’un élément. Si cette option est prise en charge, IShellFolder::BindToStorage retourne un pointeur d’interface spécifié qui peut ensuite être utilisé pour accéder au contenu de l’objet. Pour plus d’informations, consultez la référence IMoniker::BindToStorage .

Configuration requise