SHCloneSpecialIDList-Funktion (shlobj_core.h)

Artikel
03/02/2024

[SHCloneSpecialIDList ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen SHGetSpecialFolderLocation.]

Ruft einen Zeiger auf die ITEMIDLIST-Struktur ab, die einen speziellen Ordner angibt.

Syntax

PIDLIST_ABSOLUTE SHCloneSpecialIDList(
       HWND hwnd,
  [in] int  csidl,
  [in] BOOL fCreate
);

Parameter

hwnd

Typ: HWND

Reserviert.

[in] csidl

Typ: int

Ein CSIDL-Wert , der den relevanten Ordner identifiziert.

[in] fCreate

Typ: BOOL

Ein Wert vom Typ BOOL , der angibt, ob der Ordner erstellt werden soll, wenn er noch nicht vorhanden ist. Wenn fCreateauf TRUE festgelegt ist, wird der Ordner erstellt. Wenn der Wert FALSE ist, wird der Ordner nicht erstellt.

Rückgabewert

Typ: PIDLIST_ABSOLUTE

Gibt einen Zeiger auf die ITEMIDLIST-Struktur eines speziellen Ordners zurück, der von csidl angegeben wird. Die Funktion erstellt den Ordner, wenn fCreateden Wert TRUE aufweist.

Hinweise

Wenn Sie fertig sind, sollten Sie den Zeiger auf den geklonten Ordner mit ILFree freigeben.

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

Freigeben über