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