Fonction PathResolve (shlobj_core.h)

Article
03/02/2024

[PathResolve est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Convertit un nom de chemin d’accès relatif ou non qualifié en un nom de chemin complet.

Syntaxe

int PathResolve(
  [in, out]      PWSTR    pszPath,
  [in, optional] PZPCWSTR dirs,
                 UINT     fFlags
);

Paramètres

[in, out] pszPath

Type : PWSTR

Chaîne Unicode terminée par null qui contient le chemin d’accès à résoudre. Lorsque la fonction retourne, la chaîne contient le chemin complet correspondant. Cette mémoire tampon doit comporter au moins MAX_PATH caractères.

[in, optional] dirs

Type : PZPCWSTR

Pointeur vers un tableau de répertoires null facultatif à rechercher en premier dans le cas où le chemin d’accès ne peut pas être résolu à partir de pszPath. Cette valeur peut être NULL.

fFlags

Type : UINT

Indicateurs qui spécifient le fonctionnement de la fonction.

PRF_VERIFYEXISTS

Retourne TRUE si l’existence du fichier est vérifiée ; sinon , FALSE.

PRF_TRYPROGRAMEXTENSIONS

Recherchez le chemin spécifié avec les extensions suivantes ajoutées : .pif, .com, .bat, .cmd, .lnk et .exe.

PRF_FIRSTDIRDEF

Recherchez d’abord dans le ou les répertoires spécifiés par les dirs.

PRF_DONTFINDLNK

Ignorez les fichiers .lnk.

PRF_REQUIREABSOLUTE

Exiger un chemin d’accès absolu (complet).

Valeur retournée

Type : int

Retourne TRUE, sauf si PRF_VERIFYEXISTS est défini. Si cet indicateur est défini, la fonction retourne TRUE si le fichier est vérifié pour exister et FALSE dans le cas contraire. Il définit également un code d’erreur ERROR_FILE_NOT_FOUND que vous pouvez récupérer en appelant GetLastError.

Remarques

Une valeur de retour FALSE ne signifie pas nécessairement que le fichier n’existe pas. Cela peut signifier que la fonction est simplement incapable de trouver le fichier à partir des informations fournies.

Si PathResolve ne peut pas résoudre le chemin spécifié dans pszPath, il appelle PathFindOnPath en utilisant pszPath et dirs comme paramètres.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

PathFindOnPath

Partager via