Funzione DsRemoveDsServerA (ntdsapi.h)
La funzione DsRemoveDsServer rimuove tutte le tracce di un agente del servizio directory (DSA) dall'area globale del servizio directory.
Sintassi
NTDSAPI DWORD DsRemoveDsServerA(
[in] HANDLE hDs,
[in] LPSTR ServerDN,
[in, optional] LPSTR DomainDN,
[out, optional] BOOL *fLastDcInDomain,
[in] BOOL fCommit
);
Parametri
[in] hDs
Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred.
[in] ServerDN
Puntatore a una stringa con terminazione null che specifica il nome distinto completo del controller di dominio da rimuovere.
[in, optional] DomainDN
Puntatore a una stringa con terminazione null che specifica un dominio ospitato da ServerDN. Se questo parametro è NULL, non viene eseguita alcuna verifica per assicurarsi che ServerDN sia l'ultimo controller di dominio in DomainDN.
[out, optional] fLastDcInDomain
Puntatore a un valore booleano che riceve TRUE se ServerDN è l'ultimo controller di dominio in DomainDN o FALSE in caso contrario. Questo parametro riceve FALSE se DomainDN è NULL.
[in] fCommit
Contiene un valore booleano che specifica se il controller di dominio deve effettivamente essere rimosso. Se questo parametro è diverso da zero, ServerDN viene rimosso. Se questo parametro è zero, l'esistenza di ServerDN viene selezionata e fLastDcInDomain viene scritta, ma il controller di dominio non viene rimosso.
Valore restituito
Restituisce ERROR_SUCCESS se ha esito positivo o se ha esito negativo un codice di errore Win32 o RPC. I codici di errore possibili includono quanto segue.
Commenti
Nota
L'intestazione ntdsapi.h definisce DsRemoveDsServer come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Server minimo supportato | Windows Server 2008 |
Piattaforma di destinazione | Windows |
Intestazione | ntdsapi.h |
Libreria | Ntdsapi.lib |
DLL | Ntdsapi.dll |
Vedi anche
Funzioni di gestione del controller di dominio e della replica