Méthode IKnownFolderManager ::FindFolderFromPath (shobjidl_core.h)

  • Article

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

Voir aussi

IKnownFolderManager

Dossiers connus, exemple