SHILCreateFromPath-Funktion (shlobj_core.h)

Artikel
03/02/2024

[SHILCreateFromPath ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Anwendungen sollten stattdessen SHParseDisplayName verwenden.

Erstellt einen Zeiger auf eine Elementbezeichnerliste (PIDL) aus einem Pfad.

Syntax

SHSTDAPI SHILCreateFromPath(
  [in]                PCWSTR           pszPath,
  [out]               PIDLIST_ABSOLUTE *ppidl,
  [in, out, optional] DWORD            *rgfInOut
);

Parameter

[in] pszPath

Typ: PCWSTR

Ein Zeiger auf eine null-endende Zeichenfolge mit maximaler Länge MAX_PATH, die den zu konvertierenden Pfad enthält.

[out] ppidl

Typ: PIDLIST_ABSOLUTE*

Der Pfad in pszPath , ausgedrückt als PIDL.

[in, out, optional] rgfInOut

Typ: DWORD*

Ein Zeiger auf einen DWORD-Wert , der bei einem Eintrag alle Attribute des Ordners namens in pszPath angibt, die die aufrufende Anwendung zusammen mit der PIDL abrufen möchte. Beim Beenden enthält dieser Wert die angeforderten Attribute. Eine Liste der möglichen Attributflags für diesen Parameter finden Sie unter IShellFolder::GetAttributesOf.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. 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 (shlobj.h einschließen)
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)

Share via