Funzione DsReplicaGetInfo2W (ntdsapi.h)

La funzione DsReplicaGetInfo2 recupera i dati dello stato della replica dal servizio directory. Questa funzione consente il paging dei risultati nei casi in cui sono presenti più di 1000 voci da recuperare.

Sintassi

NTDSAPI DWORD DsReplicaGetInfo2W(
  [in]           HANDLE            hDS,
  [in]           DS_REPL_INFO_TYPE InfoType,
  [in, optional] LPCWSTR           pszObject,
  [in, optional] UUID              *puuidForSourceDsaObjGuid,
  [in, optional] LPCWSTR           pszAttributeName,
  [in, optional] LPCWSTR           pszValue,
  [in]           DWORD             dwFlags,
  [in]           DWORD             dwEnumerationContext,
  [out]          VOID              **ppInfo
);

Parametri

[in] hDS

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

[in] InfoType

Contiene uno dei valori DS_REPL_INFO_TYPE che specifica il tipo di dati di replica da recuperare. Questo valore determina anche il tipo di struttura restituito in ppInfo.

[in, optional] pszObject

Puntatore a una stringa Unicode con terminazione Null costante che identifica l'oggetto per cui recuperare i dati di replica. Il significato di questo parametro dipende dal valore del parametro InfoType . Di seguito sono riportati i codici di valore possibili.

DS_REPL_INFO_NEIGHBORS

pszObject identifica il contesto di denominazione per cui vengono richiesti i vicini di replica.

DS_REPL_INFO_CURSORS_FOR_NC

pszObject identifica il contesto di denominazione per cui vengono richiesti i cursori di replica.

DS_REPL_INFO_METADATA_FOR_OBJ

pszObject identifica l'oggetto per il quale vengono richiesti i metadati di replica.

DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES

pszObject deve essere NULL.

DS_REPL_INFO_KCC_DSA_LINK_FAILURES

pszObject deve essere NULL.

DS_REPL_INFO_PENDING_OPS

pszObject deve essere NULL.

DS_REPL_INFO_METADATA_FOR_ATTR_VALUE

pszObject identifica l'oggetto per il quale vengono richiesti i metadati di replica degli attributi.

DS_REPL_INFO_CURSORS_2_FOR_NC

DS_REPL_INFO_CURSORS_3_FOR_NC

DS_REPL_INFO_METADATA_2_FOR_OBJ

pszObject identifica l'oggetto per il quale vengono richiesti i metadati di replica.

DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE

pszObject identifica l'oggetto per il quale vengono richiesti i metadati di replica degli attributi.

[in, optional] puuidForSourceDsaObjGuid

Puntatore a un valore GUID che identifica un'origine di replica specifica. Se questo parametro non è NULL e il parametro InfoType contiene DS_REPL_INFO_NEIGHBORS, vengono restituiti solo i dati adiacenti per l'origine corrispondente all'oggetto nTDSDSA con l'oggetto objectGuid specificato nella directory. Questo parametro viene ignorato se NULL o se il parametro InfoType è diverso da DS_REPL_INFO_NEIGHBORS.

[in, optional] pszAttributeName

Puntatore a una stringa Unicode con terminazione Null contenente il nome dell'attributo specifico per cui recuperare i dati di replica.

Questo parametro viene usato solo se il parametro InfoType contiene uno dei valori seguenti.

DS_REPL_INFO_METADATA_FOR_ATTR_VALUE

DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE

[in, optional] pszValue

Puntatore a una stringa Unicode con terminazione Null contenente il valore del nome distinto da trovare. Se l'attributo richiesto è un valore di tipo nome distinto, questa funzione restituisce gli attributi che contengono il valore specificato.

[in] dwFlags

Contiene un set di flag che modificano il comportamento della funzione. Questo parametro può essere zero o il valore seguente.

DS_REPL_INFO_FLAG_IMPROVE_LINKED_ATTRS

Fa in modo che i metadati dell'attributo tengano conto dei metadati sui valori collegati dell'attributo. Il vettore risultante rappresenta le modifiche per tutti gli attributi. Questo vettore modificato è utile per i client che prevedono che tutti gli attributi e i metadati vengano inclusi nel vettore di metadati dell'attributo.

[in] dwEnumerationContext

Contiene l'indice della voce successiva da recuperare. Questo parametro deve essere impostato su zero la prima volta che questa funzione viene chiamata.

Questo parametro viene usato solo se il parametro InfoType contiene uno dei valori seguenti.

DS_REPL_INFO_CURSORS_2_FOR_NC

DS_REPL_INFO_CURSORS_3_FOR_NC

DS_REPL_INFO_METADATA_FOR_ATTR_VALUE

DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE

Questa funzione recupererà un massimo di 1000 voci in ogni chiamata. Se dopo aver chiamato questa funzione sono disponibili più voci, il membro dwEnumerationContext della struttura recuperata conterrà l'indice della voce successiva da recuperare. Il membro dwEnumerationContext della struttura recuperata viene quindi usato come parametro dwEnumerationContext nella chiamata successiva a questa funzione. Quando tutte le voci sono state recuperate, il membro dwEnumerationContext della struttura recuperata conterrà -1. Se viene passato -1 per questo parametro, questa funzione restituirà ERROR_NO_MORE_ITEMS.

[out] ppInfo

Indirizzo di un puntatore di struttura che riceve i dati richiesti. Il valore del parametro InfoType determina il formato di questa struttura. Per altre informazioni e un elenco dei possibili valori di InfoType e dei tipi di struttura corrispondenti, vedere DS_REPL_INFO_TYPE.

Il chiamante deve liberare questa memoria quando non è più necessaria chiamando DsReplicaFreeInfo.

Valore restituito

Restituisce ERROR_SUCCESS se l'operazione ha esito positivo o un errore Win32 o RPC in caso contrario. Di seguito sono riportati i possibili codici di errore.

Requisiti

Vedi anche

Funzioni di gestione del controller di dominio e della replica

DsBind

DsReplicaFreeInfo