Búsqueda de referencias con IDirectorySearch

Una referencia es el mecanismo que usa un servidor de directorios para dirigir un cliente a otro servidor cuando no contiene datos suficientes sobre el objeto solicitado por una consulta.

En una búsqueda de un solo nivel o subárbol, las referencias se devuelven solo para contenedores de configuración, esquema o dominio conocidos subordinados inmediatamente; es decir, dominios secundarios que son descendientes directos. Para obtener más información, vea Ámbito de búsqueda.

En un directorio, no todos los datos están disponibles en un único servidor, sino que se distribuyen a través de varios servidores diferentes a través de la red. Si los servidores comparten los datos que otros servidores pueden proporcionar, pueden proporcionar referencias a un cliente cuando no se puede resolver una consulta solicitada en el servidor de origen. Por ejemplo, cuando un cliente pide al servidor A que consulte un objeto de usuario (U), A puede sugerir que el cliente continúe la búsqueda en el servidor B si U no reside en A, pero se identifica para estar en B. El cliente tiene la opción de seguir la referencia o no. Las referencias liberan al cliente de tener que poseer conocimientos previos de la funcionalidad de cada servidor, pero el cliente debe especificar el tipo de referencias que debe realizar un servidor.

Para habilitar o deshabilitar la búsqueda de referencias, establezca una opción de búsqueda de ADS_SEARCHPREF_CHASE_REFERRALS con un valor de ADSTYPE_INTEGER que contenga uno de los valores de enumeración ADS_CHASE_REFERRALS_ENUM de la matriz de ADS_SEARCHPREF_INFO pasado al método IDirectorySearch::SetSearchPreference .

En el ejemplo de código siguiente se muestra cómo habilitar las referencias de chase.

ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_CHASE_REFERRALS;
SearchPref.vValue.dwType = ADSTYPE_INTEGER;
SearchPref.vValue.Integer = ADS_CHASE_REFERRALS_ALWAYS;

Para obtener más información sobre las referencias en Active Directory, consulte Referencias.