ADS_CHASE_REFERRALS_ENUM enumeración (iads.h)

Artículo
02/29/2024

La enumeración ADS_CHASE_REFERRALS_ENUM especifica si y cómo se produce el seguimiento de referencias. Cuando un servidor determina que otros servidores contienen datos relevantes, en parte o en su conjunto, puede hacer referencia al cliente a otro servidor para obtener el resultado. El seguimiento de referencias es la acción realizada por un cliente para ponerse en contacto con el servidor al que se hace referencia para continuar la búsqueda del directorio.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0024 {
  ADS_CHASE_REFERRALS_NEVER = 0,
  ADS_CHASE_REFERRALS_SUBORDINATE = 0x20,
  ADS_CHASE_REFERRALS_EXTERNAL = 0x40,
  ADS_CHASE_REFERRALS_ALWAYS
} ADS_CHASE_REFERRALS_ENUM;

Constantes


`ADS_CHASE_REFERRALS_NEVER` Valor: 0 El cliente nunca debe perseguir al servidor al que se hace referencia. El establecimiento de esta opción impide que un cliente establezca contacto con otros servidores en un proceso de referencia.
`ADS_CHASE_REFERRALS_SUBORDINATE` Valor: 0x20 El cliente solo persigue las referencias subordinadas que son un contexto de nomenclatura subordinado en un árbol de directorios. Por ejemplo, si se solicita la búsqueda base para "DC=Fabrikam,DC=Com", y el servidor devuelve un conjunto de resultados y una referencia de "DC=Sales,DC=Fabrikam,DC=Com" en el servidor AdbSales, el cliente puede ponerse en contacto con el servidor AdbSales para continuar la búsqueda. El proveedor LDAP de ADSI siempre desactiva este marcador para búsquedas paginadas.
`ADS_CHASE_REFERRALS_EXTERNAL` Valor: 0x40 El cliente persigue referencias externas. Por ejemplo, un cliente solicita al servidor A que realice una búsqueda de "DC=Fabrikam,DC=Com". Sin embargo, el servidor A no contiene el objeto , pero sabe que un servidor independiente, B, lo posee. A continuación, hace referencia al cliente al servidor B.
`ADS_CHASE_REFERRALS_ALWAYS` Las referencias se persiguen para el tipo subordinado o externo.

Comentarios

Use las constantes de esta enumeración para configurar las preferencias de búsqueda para el seguimiento de referencias. La acción equivale a asignar los campos adecuados de la estructura ADS_SEARCHPREF_INFO con elementos de las enumeraciones ADS_CHASE_REFERRALS_ENUM y ADS_SEARCHPREF_ENUM . Los valores de esta enumeración también se pueden usar con IADsObjectOptions para especificar si se debe realizar el seguimiento de referencias al enumerar los objetos de un objeto contenedor.

La interfaz IADsNameTranslate tiene una implementación parcial de ADS_CHASE_REFERRALS_ENUM a través de la propiedad ChaseReferral . Si la propiedad ChaseReferral se establece en cero (0), es igual que especificar ADS_CHASE_REFERRALS_NEVER (0). Si se usa un valor distinto de cero, es el mismo que especificar ADS_CHASE_REFERRALS_ALWAYS (0x60). IADsNameTranslate no implementa las opciones de ADS_CHASE_REFERRALS_SUBORDINATE (0x20) ni ADS_CHASE_REFERRALS_EXTERNAL (0x40).

El proveedor LDAP adsi admite referencias externas para búsquedas paginadas, pero no admite referencias subordinadas durante la paginación.

Nota Dado que VBScript no puede leer datos de una biblioteca de tipos, las aplicaciones vbScript no comprenden las constantes simbólicas como se ha definido anteriormente. En su lugar, debe usar las constantes numéricas para establecer las marcas adecuadas en las aplicaciones VBScript. Si desea usar las constantes simbólicas como procedimiento de programación recomendado, debe realizar declaraciones explícitas de estas constantes, como se hace aquí, en las aplicaciones vbScript.