SetComputerNameA, fonction (sysinfoapi.h)
Définit un nouveau nom NetBIOS pour l’ordinateur local. Le nom est stocké dans le Registre et le changement de nom prend effet la prochaine fois que l’utilisateur redémarre l’ordinateur.
Si l’ordinateur local est un nœud dans un cluster, SetComputerName définit le nom NetBIOS de l’ordinateur local, et non celui du serveur virtuel du cluster.
Pour définir le nom d’hôte DNS ou le nom de domaine DNS, appelez la fonction SetComputerNameEx .
Syntaxe
BOOL SetComputerNameA(
[in] LPCSTR lpComputerName
);
Paramètres
[in] lpComputerName
Nom de l’ordinateur qui prendra effet lors du prochain démarrage de l’ordinateur. Le nom ne doit pas dépasser MAX_COMPUTERNAME_LENGTH caractères.
Le jeu de caractères standard comprend des lettres, des chiffres et les symboles suivants : ! @ # $ % ^ & ' ) ( . - _ { } ~ . Si ce paramètre contient un ou plusieurs caractères en dehors du jeu de caractères standard, SetComputerName retourne ERROR_INVALID_PARAMETER.
Valeur retournée
Si la fonction réussit, la valeur de retour est une valeur différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Les applications utilisant cette fonction doivent disposer de droits d’administrateur.
Notes
L’en-tête sysinfoapi.h définit SetComputerName 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. La combinaison 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 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | sysinfoapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |