Funzione DsReplicaDelA (ntdsapi.h)

Articolo
03/05/2024

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

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 nc di destinazione da cui rimuovere la replica. Il record NC di destinazione deve esistere localmente come oggetto, creata o meno, 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 viene 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 la parte GUID del nome è il 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 qualsiasi errore generato dal contatto dell'origine per indicare che rimuove questo nc dall'elenco dei server in cui viene replicato.

DS_REPDEL_INTERSITE_MESSAGING

Indica che la replica è basata su posta elettronica anziché sincronizzata usando RPC del servizio directory nativo.

DS_REPDEL_LOCAL_ONLY

Non contatta l'origine per indicare la rimozione di questo nc dall'elenco dei server a cui replica. Se questo flag non è impostato e il collegamento è basato su RPC, l'origine viene contattata.

DS_REPDEL_NO_SOURCE

Elimina tutti gli oggetti in NC. Questa opzione è valida solo per le schede 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 API Win32 standard o ERROR_INVALID_PARAMETER se un parametro non è valido.

Commenti

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 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