SHGetPathFromIDListEx-Funktion (shlobj_core.h)

  • Artikel

Konvertiert eine Elementbezeichnerliste in einen Dateisystempfad. Diese Funktion erweitert SHGetPathFromIDList , indem Sie die Anfangsgröße des Zeichenfolgenpuffers festlegen und die folgenden Optionen deklarieren können.

Syntax

BOOL SHGetPathFromIDListEx(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] PWSTR             pszPath,
        DWORD             cchPath,
        GPFIDL_FLAGS      uOpts
);

Parameter

[in] pidl

Typ: PCIDLIST_ABSOLUTE

Ein Zeiger auf eine Elementbezeichnerliste, der einen Datei- oder Verzeichnisspeicherort relativ zum Stammverzeichnis des Namespace (desktop) angibt.

[out] pszPath

Typ: PWSTR

Wenn diese Funktion aufgerufen wird, wird ein null-terminierter Unicode-Puffer übergeben, um den Dateisystempfad zu empfangen. Dieser Puffer hat die Größe cchPath.

Wenn diese Funktion zurückgibt, enthält die Adresse eines mit NULL beendeten Unicode-Puffers, der den Dateisystempfad enthält. Dieser Puffer hat die Größe cchPath.

cchPath

Art: DWORD

Die Größe des Puffers, auf den pszPath in Zeichen verweist.

uOpts

Typ: GPFIDL_FLAGS

Diese Flags bestimmen den Typ des zurückgegebenen Pfads.

GPFIDL_DEFAULT (0x0000)

Win32-Dateinamen, Server und Stammlaufwerke sind enthalten.

GPFIDL_ALTNAME (0x0001)

Verwendet kurze Dateinamen.

GPFIDL_UNCPRINTER (0x0002)

Fügen Sie UNC-Druckernamenelemente hinzu.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn dies erfolgreich war. andernfalls FALSE.

Hinweise

Mit Ausnahme von UNC-Druckernamen tritt bei dieser Funktion ein Fehler auf, wenn der durch den pidl-Parameter angegebene Speicherort nicht Teil des Dateisystems ist.

Wenn der pidl-Parameter eine Verknüpfung angibt, enthält der pszPath den Pfad zur Verknüpfung und nicht zum Ziel der Verknüpfung.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (shlobj.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll
APIs ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

SHParseDisplayName