ILCreateFromPathA-Funktion (shlobj_core.h)

  • Artikel

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

Syntax

PIDLIST_ABSOLUTE ILCreateFromPathA(
  [in] PCSTR pszPath
);

Parameter

[in] pszPath

Typ: PCTSTR

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

Rückgabewert

Typ: PIDLIST_ABSOLUTE

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

Hinweise

Rufen Sie ILFree auf, um die ITEMIDLIST zu freigeben, wenn Sie damit fertig sind.

Hinweis

Der shlobj_core.h-Header definiert ILCreateFromPath als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
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, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)