SHBindToFolderIDListParentEx-Funktion (shlobj_core.h)

Artikel
03/06/2024

Erweitert die SHBindToFolderIDListParent-Funktion , indem der Aufrufer einen Bindungskontext angeben kann.

Syntax

SHSTDAPI SHBindToFolderIDListParentEx(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in, optional]  IBindCtx           *ppbc,
  [in]            REFIID             riid,
  [out]           void               **ppv,
  [out, optional] PCUITEMID_CHILD    *ppidlLast
);

Parameter

[in, optional] psfRoot

Typ: IShellFolder*

Ein Zeiger auf ein Shell-Ordnerobjekt. Wenn psfRootNULL ist, gibt an, dass die übergebene IDList relativ zum Desktop ist.

[in] pidl

Typ: PCUIDLIST_RELATIVE

Eine PIDL, an die im Verhältnis zu psfRoot gebunden werden soll. Wenn psfRootNULL ist, ist dies eine absolute IDList relativ zum Desktopordner.

[in, optional] ppbc

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, was dem Aufrufen der FUNKTION SHBindToFolderIDListParent entspricht. 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

Verweis auf die gewünschte Schnittstellen-ID. Dies ist in der Regel IID_IShellFolder oder IID_IShellFolder2, kann aber vom Zielordner unterstützt werden.

[out] ppv

Typ: void**

Wenn diese Funktion zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IShellFolder oder IShellFolder2, kann jedoch alles sein, was vom Zielordner unterstützt wird.

[out, optional] ppidlLast

Typ: PCUITEMID_CHILD*

Ein Zeiger auf die letzte ID des pidl-Parameters und ist eine untergeordnete ID relativ zum übergeordneten Ordner, der in ppv zurückgegeben wird. Dieser Wert kann NULL sein.

Rückgabewert

Typ: HRESULT

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

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

SHBindToFolderIDListParent

Freigeben über