Compartilhar via


Função GetComputerNameA (winbase.h)

Recupera o nome NetBIOS do computador local. Esse nome é estabelecido na inicialização do sistema, quando o sistema o lê do registro.

GetComputerName recupera apenas o nome NetBIOS do computador local. Para recuperar o nome do host DNS, o nome de domínio DNS ou o nome DNS totalmente qualificado, chame a função GetComputerNameEx . Informações adicionais são fornecidas pela interface IADsADSystemInfo .

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.

Sintaxe

BOOL GetComputerNameA(
  [out]     LPSTR   lpBuffer,
  [in, out] LPDWORD nSize
);

Parâmetros

[out] lpBuffer

Um ponteiro para um buffer que recebe o nome do computador ou o nome do servidor virtual do cluster. O tamanho do buffer deve ser grande o suficiente para conter MAX_COMPUTERNAME_LENGTH + 1 caracteres.

[in, out] nSize

Na entrada, especifica o tamanho do buffer, em TCHARs. Na saída, 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_BUFFER_OVERFLOW. O parâmetro lpnSize especifica o tamanho do buffer necessário, incluindo o caractere nulo de terminação.

Valor retornado

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.

Comentários

A função GetComputerName recupera o nome NetBIOS estabelecido na inicialização do sistema. 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 chamador estiver em execução em uma sessão de cliente, essa função retornará o nome do servidor. Para recuperar o nome do cliente, use a função WTSQuerySessionInformation .

Exemplos

Para obter um exemplo, consulte Obtendo informações do sistema.

Observação

O cabeçalho winbase.h define GetComputerName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Nomes de computador

GetComputerNameEx

SetComputerName

SetComputerNameEx

Funções de informações do sistema