Fonction PathBuildRootA (shlwapi.h)

Article
03/04/2024

Crée un chemin d’accès racine à partir d’un numéro de lecteur donné.

Syntaxe

LPSTR PathBuildRootA(
  [out] LPSTR pszRoot,
  [in]  int   iDrive
);

Paramètres

[out] pszRoot

Type : LPTSTR

Pointeur vers la chaîne qui reçoit le chemin racine construit. Cette mémoire tampon doit comporter au moins quatre caractères.

[in] iDrive

Type : int

Variable de type int qui indique le numéro de lecteur souhaité. Il devrait être compris entre 0 et 25.

Valeur retournée

Type : LPTSTR

Retourne l’adresse du chemin racine construit. Si l’appel échoue pour une raison quelconque (par exemple, un numéro de lecteur non valide), szRoot est retourné inchangé.

Remarques

Notes

L’en-tête shlwapi.h définit PathBuildRoot comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via