PathBuildRootW, fonction (shlwapi.h)

Article
11/20/2024

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

Syntaxe

LPWSTR PathBuildRootW(
  [out] LPWSTR 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 de taille.

[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 de retour

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

Note

L’en-tête shlwapi.h définit PathBuildRoot comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via