Função SetComputerNameA (sysinfoapi.h)
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.
Valor de retorno
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.
Observações
Os aplicativos que usam essa função devem ter direitos de administrador.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | sysinfoapi.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |