Méthode IKnownFolderManager ::FindFolderFromPath (shobjidl_core.h)
Obtient un objet qui représente un dossier connu en fonction d’un chemin d’accès de système de fichiers. L’objet vous permet d’interroger certaines propriétés de dossier, d’obtenir le chemin d’accès actuel du dossier, de rediriger le dossier vers un autre emplacement et d’obtenir le chemin du dossier sous la forme d’un ITEMIDLIST.
Syntaxe
HRESULT FindFolderFromPath(
[in] LPCWSTR pszPath,
[in] FFFP_MODE mode,
[out] IKnownFolder **ppkf
);
Paramètres
[in] pszPath
Type : LPCWSTR
Pointeur vers une chaîne Unicode terminée par null de longueur MAX_PATH qui contient un chemin d’accès à un dossier connu.
[in] mode
Type : FFFP_MODE
Une des valeurs suivantes qui spécifient la précision de la correspondance du chemin d’accès et du dossier connu :
FFFP_EXACTMATCH
Récupérez uniquement le dossier connu spécifique pour le chemin d’accès au fichier donné.
FFFP_NEARESTPARENTMATCH
Si aucune correspondance exacte n’est trouvée pour le chemin d’accès du fichier donné, récupérez le premier dossier connu qui correspond à l’un de ses dossiers parents en parcourant l’arborescence parente.
[out] ppkf
Type : IKnownFolder**
Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers l’objet IKnownFolder qui représente le dossier connu.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (inclure Shobjidl.h) |
| DLL | Shell32.dll |