Função GetComputerNameExA (sysinfoapi.h)

Recupera um nome NetBIOS ou DNS associado ao computador local. Os nomes são estabelecidos na inicialização do sistema, quando o sistema os lê do registro.

Sintaxe

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

Parâmetros

[in] NameType

O tipo de nome a ser recuperado. Esse parâmetro é um valor do tipo de enumeração COMPUTER_NAME_FORMAT. A tabela a seguir fornece informações adicionais.

[out] lpBuffer

Um ponteiro para um buffer que recebe o nome do computador ou o nome do servidor virtual do cluster.

O comprimento do nome pode ser maior que MAX_COMPUTERNAME_LENGTH caracteres porque o DNS permite nomes mais longos. Para garantir que esse buffer seja grande o suficiente, defina esse parâmetro como NULL e use o tamanho do buffer necessário retornado no parâmetro lpnSize .

[in, out] nSize

Na entrada, especifica o tamanho do buffer, em TCHARs. Na saída, recebe o número de TCHARs copiados para o buffer de destino, não incluindo o caractere nulo de terminação.

Se o buffer for muito pequeno, a função falhará e GetLastError retornará ERROR_MORE_DATA. Esse parâmetro recebe o tamanho do buffer necessário, incluindo o caractere nulo de terminação.

Se lpBuffer for NULL, esse parâmetro deverá ser zero.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Os possíveis valores incluem os seguintes.

Comentários

Se a política de grupo não estiver definida para o computador local, a função GetComputerNameEx recuperará os nomes NetBIOS ou DNS estabelecidos na inicialização do sistema. Se a política de grupo estiver definida, a função retornará o nome de domínio primário definido pela política de grupo. As alterações de nome feitas pelas funções SetComputerName ou SetComputerNameEx não entrarão em vigor até que o usuário reinicie o computador.

Se o computador local não estiver configurado para usar nomes DNS, GetComputerNameEx não retornará informações DNS. Para configurar o computador para fazer isso, siga as etapas descritas na ajuda do sistema operacional e altere o sufixo DNS primário do computador e reinicie o computador.

O comportamento dessa função pode ser afetado se o computador local for um nó em um cluster. Para obter mais informações, consulte ResUtilGetEnvironmentWithNetName e UseNetworkName.

Se você estiver trabalhando com ambientes que usam layouts DNS diferentes, em que o FQDN do computador não corresponde ao FQDN de seu domínio, use LsaQueryInformationPolicy .

Para compilar um aplicativo que usa essa função, defina a macro _WIN32_WINNT como 0x0500 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Exemplos

#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);
    }
}

Requisitos

Confira também

COMPUTER_NAME_FORMAT

Nomes de computador

GetComputerName

ResUtilGetEnvironmentWithNetName

ResUtilSetResourceServiceEnvironment

ResUtilSetResourceServiceStartParameters

SetComputerName

SetComputerNameEx

Funções de informações do sistema