SHBindToParent-Funktion (shlobj_core.h)

  • Artikel

Verwendet einen Zeiger auf eine vollqualifizierte Elementbezeichnerliste (PIDL) und gibt einen angegebenen Schnittstellenzeiger für das übergeordnete Objekt zurück.

Syntax

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

Parameter

[in] pidl

Typ: PCIDLIST_ABSOLUTE

Die PIDL des Elements.

[in] riid

Typ: REFIID

Die REFIID einer der Schnittstellen, die vom übergeordneten Objekt des Elements verfügbar gemacht werden.

[out] ppv

Typ: VOID**

Ein Zeiger auf die von riid angegebene Schnittstelle. Sie müssen das Objekt freigeben, wenn Sie fertig sind.

[out] ppidlLast

Typ: PCUITEMID_CHILD*

Die PIDL des Elements relativ zum übergeordneten Ordner. Diese PIDL kann mit vielen methoden verwendet werden, die von den Schnittstellen des übergeordneten Ordners unterstützt werden. Wenn Sie ppidlLast auf NULL festlegen, wird die PIDL nicht zurückgegeben.

HinweisSHBindToParent weist keine neue PIDL zu. Es empfängt einfach einen Zeiger über diesen Parameter. Daher sind Sie nicht für die Freigabe dieser Ressource verantwortlich.
 

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 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)