Funzione DsReplicaGetInfoW (ntdsapi.h)

Articolo
03/08/2023

La funzione DsReplicaGetInfo recupera i dati dello stato di replica dal servizio directory.

Sintassi

NTDSAPI DWORD DsReplicaGetInfoW(
  [in]           HANDLE            hDS,
  [in]           DS_REPL_INFO_TYPE InfoType,
  [in, optional] LPCWSTR           pszObject,
  [in, optional] UUID              *puuidForSourceDsaObjGuid,
  [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.

Per questa funzione sono supportati solo i valori seguenti. Se sono necessari altri tipi di dati, è necessario usare la funzione DsReplicaGetInfo2 .

DS_REPL_INFO_NEIGHBORS

DS_REPL_INFO_CURSORS_FOR_NC

DS_REPL_INFO_METADATA_FOR_OBJ

DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES

DS_REPL_INFO_KCC_DSA_LINK_FAILURES

DS_REPL_INFO_PENDING_OPS

[in, optional] pszObject

Puntatore a una stringa Unicode con terminazione null costante che identifica l'oggetto per 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 cui 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.

[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 vicini 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.

[out] ppInfo

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

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

Valore restituito

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

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