Funzione DsReplicaDelA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsReplicaDel rimuove un riferimento all'origine di replica da un contesto di denominazione di destinazione.

Sintassi

NTDSAPI DWORD DsReplicaDelA(
  [in] HANDLE hDS,
  [in] LPCSTR NameContext,
  [in] LPCSTR DsaSrc,
  [in] ULONG  Options
);

Parametri

[in] hDS

Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred.

[in] NameContext

Puntatore a una stringa con terminazione Null costante che specifica il nome distinto (DN) del controller di rete di destinazione da cui rimuovere la replica. Il record NC di destinazione deve esistere localmente come oggetto, creata o meno un'istanza o un fantasma di riferimento, ad esempio un fantasma con un GUID.

[in] DsaSrc

Puntatore a una stringa Unicode con terminazione Null costante che specifica l'indirizzo specifico del trasporto dell'agente del sistema di directory di origine .DSA. Questo server di origine è identificato da un nome stringa, non dal relativo UUID . Un nome stringa appropriato per DsaSrc è in genere un nome DNS basato su un GUID , dove il GUID parte del nome è il GUID GUID dell'oggetto nTDSDSA per il server di origine.

[in] Options

Passa dati aggiuntivi usati per elaborare la richiesta. Questo parametro può essere una combinazione dei valori seguenti.

DS_REPDEL_ASYNCHRONOUS_OPERATION

Esegue questa operazione in modo asincrono.

DS_REPDEL_IGNORE_ERRORS

Ignora eventuali errori generati dal contatto dell'origine per indicare di rimuovere il controller di rete dall'elenco dei server in cui viene replicato.

DS_REPDEL_INTERSITE_MESSAGING

Indica che la replica è basata sulla posta elettronica anziché essere sincronizzata tramite RPC del servizio directory nativo.

DS_REPDEL_LOCAL_ONLY

Non contatta l'origine per indicare di rimuovere il controller di rete dall'elenco dei server in cui viene replicato. Se questo flag non è impostato e il collegamento è basato su RPC, l'origine viene contattata.

DS_REPDEL_NO_SOURCE

Elimina tutti gli oggetti nel controller di rete. Questa opzione è valida solo per i controller di rete di sola lettura senza origine.

DS_REPDEL_REF_OK

Consente l'eliminazione di una replica di sola lettura anche se esegue l'origine di altre repliche di sola lettura.

DS_REPDEL_WRITEABLE

Indica che la replica eliminata può essere scritta in .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un errore standard dell'API Win32 o ERROR_INVALID_PARAMETER se un parametro non è valido.

Osservazioni

Nota

L'intestazione ntdsapi.h definisce DsReplicaDel 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