IKnownFolderManager::FindFolderFromPath-Methode (shobjidl_core.h)

  • Artikel

Ruft ein -Objekt ab, das einen bekannten Ordner basierend auf einem Dateisystempfad darstellt. Mit dem -Objekt können Sie bestimmte Ordnereigenschaften abfragen, den aktuellen Pfad des Ordners abrufen, den Ordner an einen anderen Speicherort umleiten und den Pfad des Ordners als ITEMIDLIST abrufen.

Syntax

HRESULT FindFolderFromPath(
  [in]  LPCWSTR      pszPath,
  [in]  FFFP_MODE    mode,
  [out] IKnownFolder **ppkf
);

Parameter

[in] pszPath

Typ: LPCWSTR

Zeiger auf eine mit NULL endende Unicode-Zeichenfolge der Länge MAX_PATH, die einen Pfad zu einem bekannten Ordner enthält.

[in] mode

Typ: FFFP_MODE

Einer der folgenden Werte, der die Genauigkeit der Übereinstimmung von Pfad und bekanntem Ordner angibt:

FFFP_EXACTMATCH

Rufen Sie nur den bestimmten bekannten Ordner für den angegebenen Dateipfad ab.

FFFP_NEARESTPARENTMATCH

Wenn keine genaue Übereinstimmung für den angegebenen Dateipfad gefunden wird, rufen Sie den ersten bekannten Ordner ab, der mit einem seiner übergeordneten Ordner übereinstimmt, der in der übergeordneten Struktur nach oben geht.

[out] ppkf

Typ: IKnownFolder**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das IKnownFolder-Objekt , das den bekannten Ordner darstellt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

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 shobjidl_core.h (shobjidl.h einschließen)
DLL Shell32.dll

Weitere Informationen

IKnownFolderManager

Bekannte Ordner (Beispiel)