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