IShellFolder::BindToStorage-Methode (shobjidl_core.h)

Artikel
08/26/2023

Fordert einen Zeiger auf die Speicherschnittstelle eines Objekts an.

Syntax

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

Parameter

[in] pidl

Typ: PCUIDLIST_RELATIVE

Die Adresse einer ITEMIDLIST-Struktur , die den Unterordner relativ zum übergeordneten Ordner identifiziert. Die Struktur muss genau eine SHITEMID-Struktur gefolgt von einer endenden Null enthalten.

[in] pbc

Typ: IBindCtx*

Die optionale Adresse einer IBindCtx-Schnittstelle für ein Bindungskontextobjekt, das während dieses Vorgangs verwendet werden soll. Wenn dieser Parameter nicht verwendet wird, legen Sie ihn auf NULL fest. Da die Unterstützung für pbc für Ordnerobjektimplementierungen optional ist, unterstützen einige Ordner möglicherweise nicht die Verwendung von Bindungskontexten.

[in] riid

Typ: REFIID

Die IID der angeforderten Speicherschnittstelle. Um einen IStream-, IStorage- oder IPropertySetStorage-Schnittstellenzeiger abzurufen, legen Sie riid auf IID_IStream, IID_IStorage oder IID_IPropertySetStorage fest.

[out] ppv

Typ: void**

Die Adresse, die den durch riid angegebenen Schnittstellenzeiger empfängt. Wenn ein Fehler auftritt, wird in dieser Adresse ein NULL-Zeiger zurückgegeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Namespaceerweiterungen haben die Möglichkeit, Anwendungen die Bindung an ein Objekt zu gestatten, das den Speicher eines Elements darstellt. Wenn diese Option unterstützt wird, gibt IShellFolder::BindToStorage einen angegebenen Schnittstellenzeiger zurück, der dann für den Zugriff auf den Inhalt des Objekts verwendet werden kann. Weitere Informationen finden Sie in der Referenz IMoniker::BindToStorage .

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über