Función DsReplicaGetInfo2W (ntdsapi.h)

La función DsReplicaGetInfo2 recupera los datos de estado de replicación del servicio de directorio. Esta función permite la paginación de los resultados en casos en los que hay más de 1000 entradas para recuperar.

Sintaxis

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
);

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.

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

DS_REPL_INFO_METADATA_FOR_ATTR_VALUE

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

DS_REPL_INFO_CURSORS_2_FOR_NC

DS_REPL_INFO_CURSORS_3_FOR_NC

DS_REPL_INFO_METADATA_2_FOR_OBJ

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

DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE

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

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

[in, optional] pszAttributeName

Puntero a una cadena Unicode terminada en null que contiene el nombre del atributo específico para el que recuperar los datos de replicación.

Este parámetro solo se usa si el parámetro InfoType contiene uno de los valores siguientes.

DS_REPL_INFO_METADATA_FOR_ATTR_VALUE

DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE

[in, optional] pszValue

Puntero a una cadena Unicode terminada en null que contiene el valor de nombre distintivo que debe coincidir. Si el atributo solicitado es un valor de tipo de nombre distintivo, esta función devuelve los atributos que contienen el valor especificado.

[in] dwFlags

Contiene un conjunto de marcas que modifican el comportamiento de la función. Este parámetro puede ser cero o el valor siguiente.

DS_REPL_INFO_FLAG_IMPROVE_LINKED_ATTRS

Hace que los metadatos de atributo tenga en cuenta los metadatos de los valores vinculados del atributo. El vector resultante representa los cambios de todos los atributos. Este vector modificado es útil para los clientes que esperan que todos los atributos y metadatos se incluyan en el vector de metadatos del atributo.

[in] dwEnumerationContext

Contiene el índice de la entrada siguiente que se va a recuperar. Este parámetro debe establecerse en cero la primera vez que se llama a esta función.

Este parámetro solo se usa si el parámetro InfoType contiene uno de los valores siguientes.

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

Esta función recuperará un máximo de 1000 entradas en cada llamada. Si después de llamar a esta función, hay más entradas disponibles, el miembro dwEnumerationContext de la estructura recuperada contendrá el índice de la entrada siguiente que se va a recuperar. A continuación, el miembro dwEnumerationContext de la estructura recuperada se usa como parámetro dwEnumerationContext en la siguiente llamada a esta función. Cuando se han recuperado todas las entradas, el miembro dwEnumerationContext de la estructura recuperada contendrá -1. Si se pasa -1 para este parámetro, esta función devolverá ERROR_NO_MORE_ITEMS.

[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 un error de Win32 o RPC en caso contrario. A continuación se muestran 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

Consulte también

Funciones de administración de replicación y controlador de dominio

DsBind

DsReplicaFreeInfo