Fonctions de gestion des chemins d’interpréteur de commandes

Cette section décrit les fonctions de gestion des chemins d’accès Windows Shell. Les éléments de programmation expliqués dans cette documentation sont exportés par Shlwapi.dll et définis dans Shlwapi.h et Shlwapi.lib.

Contenu de cette section

Sujet	Description
PathAddBackslash	Ajoute une barre oblique inverse à la fin d’une chaîne pour créer la syntaxe correcte pour un chemin d’accès. Si le chemin source a déjà une barre oblique inverse de fin, aucune barre oblique inverse n’est ajoutée. Remarque : L’utilisation incorrecte de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction PathCchAddBackslash ou PathCchAddBackslashEx plus sûre à sa place.
PathAddExtension	Ajoute une extension de nom de fichier à une chaîne de chemin d’accès. Remarque : L’utilisation incorrecte de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction PathCchAddExtension plus sûre à sa place.
PathAppend	Ajoute un chemin à la fin d’un autre. Remarque : L’utilisation incorrecte de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction PathCchAppend ou PathCchAppendEx plus sûre à sa place.
PathBuildRoot	Crée un chemin racine à partir d’un numéro de lecteur donné.
PathCanonicalize	Simplifie un chemin en supprimant les éléments de navigation tels que « » et « ». pour produire un chemin direct et bien formé.
PathCombine	Concatène deux chaînes qui représentent des chemins correctement formés en un seul chemin ; concatène également tous les éléments de chemin d’accès relatifs. Remarque : L’utilisation incorrecte de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction PathCchCombine ou PathCchCombineEx plus sûre à sa place.
PathCommonPrefix	Compare deux chemins pour déterminer s’ils partagent un préfixe commun. Un préfixe est l’un des types suivants : « C :\ », « ». », « ». ». \".
PathCompactPath	Tronque un chemin d’accès de fichier pour s’adapter à une largeur de pixel donnée en remplaçant les composants de chemin d’accès par des points de suspension.
PathCompactPathEx	Tronque un chemin d’accès à un certain nombre de caractères en remplaçant les composants de chemin d’accès par des points de suspension.
PathCreateFromUrl	Convertit une URL de fichier en chemin Microsoft MS-DOS.
PathCreateFromUrlAlloc	Crée un chemin d’accès à partir d’une URL de fichier.
PathFileExists	Détermine si un chemin d’accès à un objet système de fichiers tel qu’un fichier ou un dossier est valide.
PathFindExtension	Recherche un chemin d’accès pour une extension.
PathFindFileName	Recherche un chemin d’accès pour un nom de fichier.
PathFindNextComponent	Analyse un chemin et retourne la partie de ce chemin qui suit la première barre oblique inverse.
PathFindOnPath	Recherche un fichier.
PathFindSuffixArray	Détermine si un nom de fichier donné a une liste de suffixes.
PathGetArgs	Recherche les arguments de ligne de commande dans un chemin donné.
PathGetCharType	Détermine le type de caractère par rapport à un chemin d’accès.
PathGetDriveNumber	Recherche un chemin d’accès pour une lettre de lecteur dans la plage de « A » à « Z » et retourne le numéro de lecteur correspondant.
PathIsContentType	Détermine si le type de contenu inscrit d’un fichier correspond au type de contenu spécifié. Cette fonction obtient le type de contenu pour le type de fichier spécifié et compare cette chaîne avec le pszContentType. La comparaison ne respecte pas la casse.
PathIsDirectory	Vérifie qu’un chemin d’accès est un répertoire valide.
PathIsDirectoryEmpty	Détermine si un chemin spécifié est un répertoire vide.
PathIsFileSpec	Recherche un chemin d’accès pour les caractères délimitant le chemin d’accès (par exemple, ' :' ou ''). S’il n’y a pas de caractères de limitation de chemin d’accès présents, le chemin d’accès est considéré comme un chemin de spécification de fichier.
PathIsHTMLFile	Détermine si un fichier est un fichier HTML. La détermination est effectuée en fonction du type de contenu inscrit pour l’extension du fichier.
PathIsLFNFileSpec	Détermine si un nom de fichier est au format long.
PathIsNetworkPath	Détermine si une chaîne de chemin d’accès représente une ressource réseau.
PathIsPrefix	Recherche un chemin d’accès pour déterminer s’il contient un préfixe valide du type passé par pszPrefix. Un préfixe est l’un des types suivants : « C :\ », « ». », « ». ». \".
PathIsRelative	Recherche un chemin d’accès et détermine s’il est relatif.
PathIsRoot	Détermine si une chaîne de chemin fait référence à la racine d’un volume.
PathIsSameRoot	Compare deux chemins pour déterminer s’ils ont un composant racine commun.
PathIsSystemFolder	Détermine si un dossier existant contient les attributs qui en font un dossier système. Sinon, cette fonction indique si certains attributs qualifient un dossier pour être un dossier système.
PathIsUNC	Détermine si une chaîne de chemin d’accès est un chemin d’accès UNC (Universal Naming Convention) valide, par opposition à un chemin d’accès basé sur une lettre de lecteur.
PathIsUNCServer	Détermine si une chaîne est un UNC valide pour un chemin d’accès au serveur uniquement.
PathIsUNCServerShare	Détermine si une chaîne est un chemin d’accès de partage UNC valide, \server<em>share.
PathIsURL	Teste une chaîne donnée pour déterminer si elle est conforme à un format d’URL valide.
PathMakePretty	Convertit un chemin d’accès en majuscules en caractères minuscules pour donner au chemin une apparence cohérente.
PathMakeSystemFolder	Donne à un dossier existant les attributs appropriés pour devenir un dossier système.
PathMatchSpec	Recherche une chaîne à l’aide d’un type de correspondance générique MS-DOS.
PathMatchSpecEx	Correspond à un nom de fichier à partir d’un chemin d’accès à un ou plusieurs modèles de nom de fichier.
PathParseIconLocation	Analyse une chaîne d’emplacement de fichier qui contient un index d’emplacement de fichier et d’icône et retourne des valeurs distinctes.
PathQuoteSpaces	Recherche un chemin d’accès aux espaces. Si des espaces sont trouvés, le chemin entier est placé entre guillemets.
PathRelativePathTo	Crée un chemin relatif d’un fichier ou d’un dossier vers un autre.
PathRemoveArgs	Supprime tous les arguments d’un chemin donné.
PathRemoveBackslash	Supprime la barre oblique inverse de fin d’un chemin donné. Remarque : cette fonction est déconseillée. Nous vous recommandons d’utiliser la fonction PathCchRemoveBackslash ou PathCchRemoveBackslashEx à sa place.
PathRemoveBlanks	Supprime tous les espaces de début et de fin d’une chaîne.
PathRemoveExtension	Supprime l’extension de nom de fichier d’un chemin d’accès, le cas échéant. Remarque : cette fonction est déconseillée. Nous vous recommandons d’utiliser PathCchRemoveExtension à sa place.
PathRemoveFileSpec	Supprime le nom du fichier de fin et la barre oblique inverse d’un chemin, s’ils sont présents. Remarque : cette fonction est déconseillée. Nous vous recommandons d’utiliser la fonction PathCchRemoveFileSpec à sa place.
PathRenameExtension	Remplace l’extension d’un nom de fichier par une nouvelle extension. Si le nom de fichier ne contient pas d’extension, l’extension est attachée à la fin de la chaîne. Remarque : L’utilisation incorrecte de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction PathCchRenameExtension plus sûre à sa place.
PathSearchAndQualify	Détermine si un chemin donné est correctement mis en forme et complet.
PathSetDlgItemPath	Définit le texte d’un contrôle enfant dans une fenêtre ou une boîte de dialogue, à l’aide de PathCompactPath pour vous assurer que le chemin s’inscrit dans le contrôle.
PathSkipRoot	Récupère un pointeur vers le premier caractère d’un chemin suivant la lettre de lecteur ou les éléments de chemin d’accès UNC server/share.
PathStripPath	Supprime la partie chemin d’accès d’un chemin d’accès complet et d’un fichier.
PathStripToRoot	Supprime tous les éléments de fichier et de répertoire dans un chemin à l’exception des informations racines. Remarque : L’utilisation incorrecte de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction PathCchStripToRoot plus sûre à sa place.
PathUndecorate	Supprime la décoration d’une chaîne de chemin d’accès.
PathUnExpandEnvStrings	Remplace certains noms de dossiers dans un chemin complet par leur chaîne d’environnement associée.
PathUnmakeSystemFolder	Supprime les attributs d’un dossier qui le rendent un dossier système. Ce dossier doit exister dans le système de fichiers.
PathUnquoteSpaces	Supprime les guillemets du début et de la fin d’un chemin d’accès.
SHSkipJunction	Vérifie un contexte de liaison pour voir s’il est sûr de se lier à un objet de composant particulier.
UrlApplyScheme	Détermine un schéma pour une chaîne d’URL spécifiée et retourne une chaîne avec un préfixe approprié.
UrlCanonicalize	Convertit une chaîne d’URL en forme canonique.
UrlCombine	Lorsqu’elle est fournie avec une URL relative et sa base, retourne une URL sous forme canonique.
UrlCompare	Effectue une comparaison sensible à la casse de deux chaînes d’URL.
UrlCreateFromPath	Convertit un chemin MS-DOS en URL canonique.
UrlEscape	Convertit des caractères ou des paires de substitution dans une URL qui peut être modifiée pendant le transport sur Internet (« caractères non sécurisés ») dans leurs séquences d’échappement correspondantes. Les paires de substitution sont des caractères compris entre U+10000 et U+10FFFF (en UTF-32) ou entre DC00 et DFFF (en UTF-16).
UrlEscapeSpaces	Macro qui convertit les caractères d’espace en leur séquence d’échappement correspondante.
UrlGetLocation	Récupère l’emplacement à partir d’une URL.
UrlGetPart	Accepte une chaîne d’URL et retourne une partie spécifiée de cette URL.
UrlHash	Hachage d’une chaîne d’URL.
URLIs	Teste si une URL est un type spécifié.
UrlIsFileUrl	Teste une URL pour déterminer s’il s’agit d’une URL de fichier.
UrlIsNoHistory	Retourne si une URL est une URL que les navigateurs n’incluent généralement pas dans l’historique de navigation.
UrlIsOpaque	Retourne si une URL est opaque.
UrlUnescape	Convertit les séquences d’échappement en caractères ordinaires.
UrlUnescapeInPlace	Convertit les séquences d’échappement en caractères ordinaires et remplace la chaîne d’origine.