IKnownFolderManager::FindFolderFromPath-Methode (shobjidl_core.h)
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 |