Funzione NetUnjoinDomain (lmjoin.h)

La funzione NetUnjoinDomain annulla la creazione di un computer da un gruppo di lavoro o da un dominio.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fUnjoinOptions
);

Parametri

[in] lpServer

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

[in] lpAccount

Puntatore a una stringa costante che specifica il nome dell'account da usare durante la connessione al controller di dominio. La stringa deve specificare un nome NetBIOS di dominio e un account utente (ad esempio REDMOND\user) o il nome dell'entità utente (UPN) dell'utente sotto forma di un nome di accesso in stile Internet ,ad esempio "someone@example.com"). Se questo parametro è NULL, viene usato il contesto del chiamante.

[in] lpPassword

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

[in] fUnjoinOptions

Specifica le opzioni di unjoin. Se questo parametro è NETSETUP_ACCT_DELETE, l'account viene disabilitato quando si verifica l'annullamento della connessione. Si noti che questa opzione non elimina l'account. Attualmente non sono state definite altre opzioni di unjoin.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 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.

Codice restituito	Descrizione
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 aggiunto da un dominio.

Commenti

Un join (e join) di un computer a un dominio o a un gruppo di lavoro può essere eseguito solo da un membro del gruppo locale Administrators nel computer di destinazione. Se si chiama la funzione NetUnjoinDomain in remoto, è necessario specificare le credenziali perché non è possibile delegare le credenziali in queste circostanze.

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

È necessario un riavvio del sistema dopo aver chiamato la funzione NetRenameMachineInDomain per il completamento dell'operazione.

Requisiti

Requisito	Valore
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

Vedi anche

NetJoinDomain

NetRenameMachineInDomain

Funzioni di gestione della rete

Panoramica sulla gestione della rete