SHBindToObject-Funktion (shlobj_core.h)

Ruft ein angegebenes Objekt mithilfe der IShellFolder::BindToObject-Methode des Shell-Namespaces ab und bindet es an dieses.

Syntax

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

Parameter

psf

Typ: IShellFolder*

Ein Zeiger auf IShellFolder. Dieser Parameter kann NULL sein. Wenn psfNULL ist, gibt dies an, dass der Parameter pidl relativ zum Desktop ist. In diesem Fall muss pidl eine absolute ITEMIDLIST angeben.

pidl

Typ: PCUIDLIST_RELATIVE

Ein Zeiger auf eine KONSTANTE ITEMIDLIST , an die relativ zu psf gebunden werden soll. Wenn psfNULL ist, ist dies eine absolute ITEMIDLIST relativ zum Desktopordner.

[in] pbc

Typ: IBindCtx*

Ein Zeiger auf die 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.

riid

Typ: REFIID

Bezeichner der zurückzugebenden Schnittstelle.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält den Schnittstellenzeiger, der in riid auf das gebundene Objekt angegeben ist. Wenn ein Fehler auftritt, enthält einen NULL-Zeiger .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis Dies ist eine Hilfsfunktion, die das Desktopobjekt durch Aufrufen von SHGetDesktopFolder abruft.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
DLL	Shell32.dll

Weitere Informationen

IShellFolder

IShellFolder::BindToObject