ILCreateFromPathW-Funktion (shlobj_core.h)

Artikel
11/20/2024

Gibt die ITEMIDLIST- Struktur zurück, die einem angegebenen Dateipfad zugeordnet ist.

Syntax

PIDLIST_ABSOLUTE ILCreateFromPathW(
  [in] PCWSTR pszPath
);

Parameter

[in] pszPath

Typ: PCTSTR-

Ein Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die den Pfad enthält. Diese Zeichenfolge darf nicht mehr als MAX_PATH Zeichen lang sein, einschließlich des endenden Nullzeichens.

Rückgabewert

Typ: PIDLIST_ABSOLUTE

Gibt einen Zeiger auf eine ITEMIDLIST- Struktur zurück, die dem Pfad entspricht.

Bemerkungen

Rufen Sie ILFree- auf, um die ITEMIDLIST- freizugeben, wenn Sie damit fertig sind.

Anmerkung

Der header shlobj_core.h definiert ILCreateFromPath als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
Library	Shell32.lib
DLL-	Shell32.dll (Version 5.0 oder höher)
API-Satz	ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)

Freigeben über