Função NetSetPrimaryComputerName (lmjoin.h)
A função NetSetPrimaryComputerName define o nome do computador primário para o computador especificado.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
[in, optional] LPCWSTR Server,
[in] LPCWSTR PrimaryName,
[in, optional] LPCWSTR DomainAccount,
[in, optional] LPCWSTR DomainAccountPassword,
[in] ULONG Reserved
);
Parâmetros
[in, optional] Server
Um ponteiro para uma cadeia de caracteres constante que especifica o nome do computador no qual executar essa função. Se esse parâmetro for NULL, o computador local será usado.
[in] PrimaryName
Um ponteiro para uma cadeia de caracteres constante que especifica o nome primário a ser definido. Esse nome deve estar na forma de um nome DNS totalmente qualificado.
[in, optional] DomainAccount
Um ponteiro para uma cadeia de caracteres constante que especifica a conta de domínio a ser usada para acessar o objeto de conta de computador do computador especificado no parâmetro Server no Active Directory. Se esse parâmetro for NULL, as credenciais do usuário que executa essa rotina serão usadas.
Esse parâmetro não será usado se o servidor para executar essa função não estiver ingressado em um domínio.
[in, optional] DomainAccountPassword
Um ponteiro para uma cadeia de caracteres constante que especifica a senha que corresponde à conta de domínio passada no parâmetro DomainAccount . Se esse parâmetro for NULL, as credenciais do usuário que executa essa rotina serão usadas.
Esse parâmetro será ignorado se o parâmetro DomainAccount for NULL. Esse parâmetro não será usado se o servidor para executar essa função não estiver ingressado em um domínio.
[in] Reserved
Reservado para uso futuro. Esse parâmetro deve ser NULL.
Retornar valor
Se a função for bem-sucedida, o valor retornado será NERR_Success.
Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro ou um dos códigos de erro do sistema.
| Código de retorno | Descrição |
|---|---|
|
Acesso negado. Esse erro será retornado se o chamador não for membro do grupo local Administradores no computador de destino. |
|
Um parâmetro de nome está incorreto. Esse erro será retornado se o parâmetro PrimaryName não contiver um nome válido. |
|
Um parâmetro está incorreto. Esse erro será retornado se o parâmetro DomainAccount não contiver um domínio válido. Esse erro também será retornado se o parâmetro DomainAccount não for NULL e o parâmetro DomainAccountPassword não for NULL , mas não contiver uma cadeia de caracteres Unicode. |
|
Não há memória suficiente disponível para processar esse comando. |
|
A solicitação não terá suporte. Esse erro será retornado se o computador de destino especificado no parâmetro Server no qual essa função é executada estiver em execução no Windows 2000 e anterior. |
|
O serviço estação de trabalho não foi iniciado. |
|
Uma chamada de procedimento remoto já está em andamento para esse thread. |
|
Não há suporte para a sequência de protocolo de chamada de procedimento remoto. |
Comentários
A função NetSetPrimaryComputerName tem suporte no Windows XP e posterior.
A função NetSetPrimaryComputerName é usada como parte das operações de renomeação do computador. O nome especificado será removido da lista de nomes alternativos configurada para o computador de destino e configurada como o nome primário. O nome da conta do computador será alterado para corresponder ao nome primário. O nome do computador primário anterior é movido para a lista de nomes de computador alternativos configurada para o computador.
A função NetSetPrimaryComputerName requer que o chamador seja membro do grupo local Administradores no computador de destino.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | lmjoin.h (inclua Lm.h) |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |