SHILCreateFromPath-Funktion (shlobj_core.h)
[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) |