GetComputerNameA, fonction (winbase.h)
Récupère le nom NetBIOS de l’ordinateur local. Ce nom est établi au démarrage du système, lorsque le système le lit à partir du Registre.
GetComputerName récupère uniquement le nom NetBIOS de l’ordinateur local. Pour récupérer le nom d’hôte DNS, le nom de domaine DNS ou le nom DNS complet, appelez la fonction GetComputerNameEx . Des informations supplémentaires sont fournies par l’interface IADsADSystemInfo .
Le comportement de cette fonction peut être affecté si l’ordinateur local est un nœud dans un cluster. Pour plus d’informations, consultez ResUtilGetEnvironmentWithNetName et UseNetworkName.
Syntaxe
BOOL GetComputerNameA(
[out] LPSTR lpBuffer,
[in, out] LPDWORD nSize
);
Paramètres
[out] lpBuffer
Pointeur vers une mémoire tampon qui reçoit le nom de l’ordinateur ou le nom du serveur virtuel du cluster. La taille de la mémoire tampon doit être suffisamment grande pour contenir MAX_COMPUTERNAME_LENGTH + 1 caractères.
[in, out] nSize
Lors de l’entrée, spécifie la taille de la mémoire tampon, en TCHAR. En sortie, nombre de TCHAR copiés dans la mémoire tampon de destination, sans compter le caractère null de fin.
Si la mémoire tampon est trop petite, la fonction échoue et GetLastError retourne ERROR_BUFFER_OVERFLOW. Le paramètre lpnSize spécifie la taille de la mémoire tampon requise, y compris le caractère null de fin.
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
La fonction GetComputerName récupère le nom NetBIOS établi au démarrage du système. Les modifications de nom apportées par les fonctions SetComputerName ou SetComputerNameEx ne prennent pas effet tant que l’utilisateur n’a pas redémarré l’ordinateur.
Si l’appelant s’exécute sous une session cliente, cette fonction retourne le nom du serveur. Pour récupérer le nom du client, utilisez la fonction WTSQuerySessionInformation .
Exemples
Pour obtenir un exemple, consultez Obtention d’informations système.
Notes
L’en-tête winbase.h définit GetComputerName en tant qu’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
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |