SHBindToFolderIDListParent-Funktion (shlobj_core.h)

Artikel
03/13/2024

Bei einem Shell-Namespaceelement, das in Form eines Ordners angegeben ist, und einer Elementbezeichnerliste relativ zu diesem Ordner, bindet diese Funktion an das übergeordnete Element des Namespaceelements und gibt optional einen Zeiger auf die letzte Komponente der Elementbezeichnerliste zurück.

Syntax

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [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 eine Bindung gebunden werden soll, relativ zu psfRoot. Wenn psfRootNULL ist, ist dies eine absolute IDList relativ zum Desktopordner.

[in] riid

Typ: REFIID

Verweis auf die gewünschte Schnittstellen-ID. Dies ist in der Regel IID_IShellFolder oder IID_IShellFolder2, kann jedoch 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 vom Zielordner unterstützt werden.

[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, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis Das Aufrufen der SHBindToFolderIDListParent-Funktion entspricht dem Aufrufen der SHBindToFolderIDListParentEx-Funktion mit NULL als Bindungskontext.

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 (shlobj.h einschließen)
DLL	Shell32.dll

Weitere Informationen

SHBindToFolderIDListParentEx

Freigeben über