Funzione DsReplicaUpdateRefsA (ntdsapi.h)

Articolo
03/08/2023

La funzione DsReplicaUpdateRefs aggiunge o rimuove un riferimento alla replica per una destinazione da un contesto di denominazione di origine.

Sintassi

NTDSAPI DWORD DsReplicaUpdateRefsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] LPCSTR     DsaDest,
  [in] const UUID *pUuidDsaDest,
  [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 del contesto di denominazione di origine.

[in] DsaDest

Puntatore a una stringa con terminazione null costante che specifica l'indirizzo specifico del trasporto dell'agente del sistema directory di destinazione.

[in] pUuidDsaDest

Puntatore a un valore UUID contenente l'agente del sistema di directory di destinazione.

[in] Options

Contiene un set di flag che forniscono dati aggiuntivi usati per elaborare la richiesta. Questo può essere zero o una combinazione di uno o più dei valori seguenti.

DS_REPUPD_ADD_REFERENCE

Un riferimento alla destinazione viene aggiunto al server di origine.

DS_REPUPD_ASYNCHRONOUS_OPERATION

L'operazione viene eseguita in modo asincrono.

DS_REPUPD_DELETE_REFERENCE

Un riferimento alla destinazione viene rimosso dal server di origine.

DS_REPUPD_WRITEABLE

Il riferimento alla replica aggiunta o rimossa è scrivibile. In caso contrario, è di sola lettura.

Valore restituito

Se la funzione ha esito positivo, viene restituito ERROR_SUCCESS .

Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti.

Commenti

Se sia DS_REPUPD_ADD_REFERENCE che DS_REPUPD_DELETE_REFERENCE vengono impostati nel parametro Opzioni, viene aggiunto un riferimento alla destinazione se non esiste già nel server. Se esiste già un riferimento alla destinazione, il riferimento viene aggiornato.

Nota

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