Funzione DsRemoveDsServerA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsRemoveDsServer rimuove tutte le tracce di un agente del servizio directory 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, viene verificata l'esistenza di serverDN e fLastDcInDomain viene scritta, ma il controller di dominio non viene rimosso.

Valore restituito

Restituisce ERROR_SUCCESS in caso di esito positivo o di un codice di errore Win32 o RPC in caso di esito negativo. I codici di errore possibili includono quanto segue.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	ntdsapi.h
libreria	Ntdsapi.lib
dll	Ntdsapi.dll

Vedere anche

controller di dominio e funzioni di gestione della replica

DsBind

DsBindWithCred

DsRemoveDsDomain

Condividi tramite