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 |
|---|---|
|
Un parametro non è corretto. |
|
Il computer non è attualmente aggiunto a un dominio. |
|
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 |