GetComputerNameW, 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 GetComputerNameW(
[out] LPWSTR 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, dans TCHAR. En sortie, le nombre de TCHAR de copiés dans la mémoire tampon de destination, sans inclure 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 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
La fonction GetComputerName récupère le nom NetBIOS établi au démarrage du système. Les modifications apportées par les fonctions SetComputerName ou SetComputerNameEx ne prennent effet qu’à ce que l’utilisateur redémarre 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.
Note
L’en-tête winbase.h définit GetComputerName 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 | Applications UWP] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |