Funzione DsRemoveDsServerA (ntdsapi.h)

Articolo
02/29/2024

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

DsBind

DsBindWithCred

DsRemoveDsDomain

Condividi tramite