SHGetRealIDL-Funktion (shlobj_core.h)

[SHGetRealIDL ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Konvertiert einen einfachen Zeiger in eine Elementbezeichnerliste (Item Identifier List, PIDL) in eine vollständige PIDL.

Syntax

SHSTDAPI SHGetRealIDL(
  [in]  IShellFolder    *psf,
  [in]  PCUITEMID_CHILD pidlSimple,
  [out] PITEMID_CHILD   *ppidlReal
);

Parameter

[in] psf

Typ: IShellFolder*

Ein Zeiger auf einen instance von IShellFolder, dessen einfache PIDL konvertiert werden soll.

[in] pidlSimple

Typ: PCUITEMID_CHILD

Die einfache PIDL, die konvertiert werden soll.

[out] ppidlReal

Typ: PITEMID_CHILD*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf die vollständige konvertierte PIDL. Wenn die Funktion fehlschlägt, wird dieser Parameter auf NULL festgelegt.

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 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)
APIs	ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)