Fonction PathResolve (shlobj_core.h)

[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

Voir aussi

PathFindOnPath