SetComputerNameA, fonction (sysinfoapi.h)
Définit un nouveau nom NetBIOS pour l’ordinateur local. Le nom est stocké dans le Registre et la modification du 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 de 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 la prochaine fois que l’ordinateur est démarré. 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 qui se trouvent en dehors du jeu de caractères standard, SetComputerName retourne ERROR_INVALID_PARAMETER.
Valeur de retour
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’erreur étendues, appelez GetLastError.
Remarques
Les applications utilisant cette fonction doivent avoir des droits d’administrateur.
Note
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. 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 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | sysinfoapi.h (include Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |