Função SetComputerNameA (sysinfoapi.h)

Artigo
08/26/2023

Define um novo nome NetBIOS para o computador local. O nome é armazenado no registro e a alteração de nome entra em vigor na próxima vez que o usuário reiniciar o computador.

Se o computador local for um nó em um cluster, SetComputerName definirá o nome NetBIOS do computador local, não o do servidor virtual do cluster.

Para definir o nome do host DNS ou o nome de domínio DNS, chame a função SetComputerNameEx .

Sintaxe

BOOL SetComputerNameA(
  [in] LPCSTR lpComputerName
);

Parâmetros

[in] lpComputerName

O nome do computador que entrará em vigor na próxima vez que o computador for iniciado. O nome não deve ter mais de MAX_COMPUTERNAME_LENGTH caracteres.

O conjunto de caracteres padrão inclui letras, números e os seguintes símbolos: ! @ # $ % ^ & ' ) ( . - _ { } ~ . Se esse parâmetro contiver um ou mais caracteres fora do conjunto de caracteres padrão, SetComputerName retornará ERROR_INVALID_PARAMETER.

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.

Comentários

Os aplicativos que usam essa função devem ter direitos de administrador.

Observação

O cabeçalho sysinfoapi.h define SetComputerName 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

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