Función DsReplicaGetInfoW (ntdsapi.h)

Artículo
03/08/2023

La función DsReplicaGetInfo recupera los datos de estado de replicación del servicio de directorio.

Sintaxis

NTDSAPI DWORD DsReplicaGetInfoW(
  [in]           HANDLE            hDS,
  [in]           DS_REPL_INFO_TYPE InfoType,
  [in, optional] LPCWSTR           pszObject,
  [in, optional] UUID              *puuidForSourceDsaObjGuid,
  [out]          VOID              **ppInfo
);

Parámetros

[in] hDS

Contiene un identificador de servicio de directorio obtenido de la función DSBind o DSBindWithCred .

[in] InfoType

Contiene uno de los valores de DS_REPL_INFO_TYPE que especifica el tipo de datos de replicación que se van a recuperar. Este valor también determina qué tipo de estructura se devuelve en ppInfo.

Solo se admiten los valores siguientes para esta función. Si se requieren otros tipos de datos, se debe usar la función 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

Puntero a una cadena Unicode terminada en null constante que identifica el objeto para el que se recuperan los datos de replicación. El significado de este parámetro depende del valor del parámetro InfoType . A continuación se muestran los códigos de valor posibles.

DS_REPL_INFO_NEIGHBORS

pszObject identifica el contexto de nomenclatura para el que se solicitan los vecinos de replicación.

DS_REPL_INFO_CURSORS_FOR_NC

pszObject identifica el contexto de nomenclatura para el que se solicitan los cursores de replicación.

DS_REPL_INFO_METADATA_FOR_OBJ

pszObject identifica el objeto para el que se solicitan los metadatos de replicación.

DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES

pszObject debe ser NULL.

DS_REPL_INFO_KCC_DSA_LINK_FAILURES

pszObject debe ser NULL.

DS_REPL_INFO_PENDING_OPS

pszObject debe ser NULL.

[in, optional] puuidForSourceDsaObjGuid

Puntero a un valor GUID que identifica un origen de replicación específico. Si este parámetro no es NULL y el parámetro InfoType contiene DS_REPL_INFO_NEIGHBORS, solo se devuelven los datos vecinos del origen correspondientes al objeto nTDSDSA con el objectGuid especificado en el directorio. Este parámetro se omite si NULL o si el parámetro InfoType es distinto de DS_REPL_INFO_NEIGHBORS.

[out] ppInfo

Dirección de un puntero de estructura que recibe los datos solicitados. El valor del parámetro InfoType determina el formato de esta estructura. Para obtener más información y una lista de los posibles valores de InfoType y los tipos de estructura correspondientes, vea DS_REPL_INFO_TYPE.

El autor de la llamada debe liberar esta memoria cuando ya no sea necesaria llamando a DsReplicaFreeInfo.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o si se produce un error win32 o RPC en caso contrario. A continuación se muestran los códigos de error posibles.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	ntdsapi.h
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll