Funzione DsReplicaUpdateRefsA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsReplicaUpdateRefs aggiunge o rimuove un riferimento di 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 di sistema della directory di destinazione.

[in] pUuidDsaDest

Puntatore a un UUID valore che contiene l'agente di sistema della directory di destinazione.

[in] Options

Contiene un set di flag che forniscono dati aggiuntivi usati per elaborare la richiesta. 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.

Osservazioni

Se sia DS_REPUPD_ADD_REFERENCE che DS_REPUPD_DELETE_REFERENCE vengono impostati nel parametro Options, viene aggiunto un riferimento alla destinazione se non ne esiste già uno 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 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