GetComputerNameA, fonction (winbase.h)

Article
08/27/2023

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