GetComputerNameExA, fonction (sysinfoapi.h)

Récupère un nom NetBIOS ou DNS associé à l’ordinateur local. Les noms sont établis au démarrage du système, lorsque le système les lit à partir du Registre.

Syntaxe

BOOL GetComputerNameExA(
  [in]      COMPUTER_NAME_FORMAT NameType,
  [out]     LPSTR                lpBuffer,
  [in, out] LPDWORD              nSize
);

Paramètres

[in] NameType

Type de nom à récupérer. Ce paramètre est une valeur du type d’énumération COMPUTER_NAME_FORMAT . Le tableau suivant fournit des informations supplémentaires.

[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 longueur du nom peut être supérieure à MAX_COMPUTERNAME_LENGTH caractères, car DNS autorise les noms plus longs. Pour vous assurer que cette mémoire tampon est suffisamment grande, définissez ce paramètre sur NULL et utilisez la taille de mémoire tampon requise retournée dans le paramètre lpnSize .

[in, out] nSize

Lors de l’entrée, spécifie la taille de la mémoire tampon, en TCHAR. À la sortie, reçoit le nombre de TCHAR 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_MORE_DATA. Ce paramètre reçoit la taille de la mémoire tampon requise, y compris le caractère null de fin.

Si lpBuffer a la valeur NULL, ce paramètre doit être égal à zéro.

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. Les valeurs possibles sont les suivantes.

Remarques

Si la stratégie de groupe n’est pas définie pour l’ordinateur local, la fonction GetComputerNameEx récupère les noms NetBIOS ou DNS établis au démarrage du système. Si la stratégie de groupe est définie, la fonction retourne le nom de domaine principal défini par stratégie de groupe. 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’ordinateur local n’est pas configuré pour utiliser des noms DNS, GetComputerNameEx ne retourne pas d’informations DNS. Pour configurer l’ordinateur, suivez les étapes décrites dans l’aide du système d’exploitation et modifiez le suffixe DNS principal de l’ordinateur, puis redémarrez l’ordinateur.

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.

Si vous travaillez avec des environnements qui utilisent des dispositions DNS différentes, où le nom de domaine complet de l’ordinateur ne correspond pas au nom de domaine complet de l’ordinateur, utilisez plutôt LsaQueryInformationPolicy .

Pour compiler une application qui utilise cette fonction, définissez la macro _WIN32_WINNT comme 0x0500 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Exemples

#define _WIN32_WINNT 0x0500

#include <windows.h>
#include <stdio.h>
#include <tchar.h>

void _tmain(void)
{
    TCHAR buffer[256] = TEXT("");
    TCHAR szDescription[8][32] = {TEXT("NetBIOS"), 
        TEXT("DNS hostname"), 
        TEXT("DNS domain"), 
        TEXT("DNS fully-qualified"), 
        TEXT("Physical NetBIOS"), 
        TEXT("Physical DNS hostname"), 
        TEXT("Physical DNS domain"), 
        TEXT("Physical DNS fully-qualified")};
    int cnf = 0;
    DWORD dwSize = _countof(buffer);
    
    for (cnf = 0; cnf < ComputerNameMax; cnf++)
    {
        if (!GetComputerNameEx((COMPUTER_NAME_FORMAT)cnf, buffer, &dwSize))
        {
            _tprintf(TEXT("GetComputerNameEx failed (%d)\n"), GetLastError());
            return;
        }
        else _tprintf(TEXT("%s: %s\n"), szDescription[cnf], buffer);

        dwSize = _countof(buffer);
        ZeroMemory(buffer, dwSize);
    }
}

Configuration requise

Voir aussi

COMPUTER_NAME_FORMAT

Noms d’ordinateurs

GetComputerName

ResUtilGetEnvironmentWithNetName

ResUtilSetResourceServiceEnvironment

ResUtilSetResourceServiceStartParameters

SetComputerName

SetComputerNameEx

Fonctions d’information système