Funzione NetRenameMachineInDomain (lmjoin.h)

Articolo
08/24/2023

La funzione NetRenameMachineInDomain modifica il nome di un computer in un dominio.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpNewMachineName,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fRenameOptions
);

Parametri

[in] lpServer

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del computer in cui chiamare la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.

[in] lpNewMachineName

Puntatore a una stringa costante che specifica il nuovo nome del computer. Se specificato, viene modificato anche il nome del computer locale. Se questo parametro è NULL, la funzione presuppone che sia già stata chiamata la funzione SetComputerNameEx .

[in] lpAccount

Puntatore a una stringa costante che specifica un nome di account da usare per la connessione al controller di dominio. Se questo parametro è NULL, viene usato il contesto del chiamante.

[in] lpPassword

Se il parametro lpAccount specifica un nome di account, questo parametro deve puntare alla password da usare per la connessione al controller di dominio. In caso contrario, questo parametro deve essere NULL.

[in] fRenameOptions

Opzioni di ridenominazione. Se questo parametro è NETSETUP_ACCT_CREATE, la funzione rinomina l'account nel dominio.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NERR_Success.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti o uno dei codici di errore di sistema seguenti.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	Accesso negato. Questo errore viene restituito se il nome dell'account passato nel parametro lpAccount non dispone di diritti di accesso sufficienti per l'operazione.
ERROR_INVALID_PARAMETER	Un parametro non è corretto.
NERR_SetupNotJoined	Il computer non è attualmente aggiunto a un dominio.
NERR_SetupDomainController	Questo computer è un controller di dominio e non può essere unito da un dominio.

Commenti

La ridenominazione di un computer di dominio può essere eseguita solo da un utente membro del gruppo locale Administrators nel computer di destinazione e che è anche membro del gruppo Administrators nel dominio o dispone del privilegio Operatore account nel dominio. Se si chiama la funzione NetRenameMachineInDomain in modalità remota, è necessario fornire le credenziali perché non è possibile delegare le credenziali in queste circostanze.

Processi diversi o thread diversi dello stesso processo non devono chiamare contemporaneamente la funzione NetRenameMachineInDomain . Questa situazione può lasciare il computer in uno stato incoerente.

I valori restituiti NERR_SetupNotJoined e NERR_SetupDomainController vengono definiti nel file di intestazione Lmerr.h. Questo file di intestazione viene incluso automaticamente dal file di intestazione Lm.h e non deve essere incluso direttamente.

Dopo aver chiamato la funzione NetRenameMachineInDomain per completare l'operazione, è necessario riavviare il sistema.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmjoin.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll