ADS_CHASE_REFERRALS_ENUM-Enumeration (iads.h)

Artikel
08/24/2023

Die ADS_CHASE_REFERRALS_ENUM-Enumeration gibt an, ob und wie die Verweisauflistung erfolgt. Wenn ein Server feststellt, dass andere Server zum Teil oder als Ganzes relevante Daten enthalten, kann er den Client auf einen anderen Server verweisen, um das Ergebnis zu erhalten. Empfehlungssuche ist die Aktion, die von einem Client ausgeführt wird, um den Server zu kontaktieren, auf den verwiesen wird, um die Verzeichnissuche fortzusetzen.

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;

Konstanten


`ADS_CHASE_REFERRALS_NEVER` Wert: 0 Der Client sollte niemals den Server verfolgen, auf den verwiesen wird. Durch Festlegen dieser Option wird verhindert, dass ein Client während eines Referenzprozesses Kontakt zu anderen Servern aufnimmt.
`ADS_CHASE_REFERRALS_SUBORDINATE` Wert: 0x20 Der Client verfolgt nur untergeordnete Verweise, die ein untergeordneter Namenskontext in einer Verzeichnisstruktur sind. Wenn beispielsweise die Basissuche für "DC=Fabrikam,DC=Com" angefordert wird und der Server ein Resultset und eine Empfehlung von "DC=Sales,DC=Fabrikam,DC=Com" auf dem AdbSales-Server zurückgibt, kann der Client den AdbSales-Server kontaktieren, um die Suche fortzusetzen. Bei der ausgelagerten Suche wird dieses Flag vom LDAP-Anbieter von ADSI immer deaktiviert.
`ADS_CHASE_REFERRALS_EXTERNAL` Wert: 0x40 Der Client verfolgt externe Empfehlungen. Beispielsweise fordert ein Client server A an, eine Suche nach "DC=Fabrikam,DC=Com" auszuführen. Server A enthält jedoch nicht das -Objekt, weiß aber, dass es von einem unabhängigen Server B besitzt. Anschließend verweist er den Client auf Server B.
`ADS_CHASE_REFERRALS_ALWAYS` Empfehlungen werden entweder für den untergeordneten oder externen Typ verfolgt.

Hinweise

Verwenden Sie die Konstanten dieser Enumeration, um Sucheinstellungen für die Verweisverfolgung einzurichten. Die Aktion umfasst das Zuweisen der entsprechenden Felder der ADS_SEARCHPREF_INFO-Struktur mit Elementen der ADS_CHASE_REFERRALS_ENUM - und ADS_SEARCHPREF_ENUM-Enumerationen . Die Werte dieser Enumeration können auch mit IADsObjectOptions verwendet werden, um anzugeben, ob beim Aufzählen der Objekte unter einem Containerobjekt verweis chasing erfolgen soll.

Die IADsNameTranslate-Schnittstelle verfügt über eine partielle Implementierung von ADS_CHASE_REFERRALS_ENUM über die ChaseReferral-Eigenschaft . Wenn die ChaseReferral-Eigenschaft auf Null (0) festgelegt ist, entspricht dies der Angabe ADS_CHASE_REFERRALS_NEVER (0). Wenn ein Wert ungleich null verwendet wird, entspricht dies der Angabe ADS_CHASE_REFERRALS_ALWAYS (0x60). IADsNameTranslate implementiert nicht die Optionen ADS_CHASE_REFERRALS_SUBORDINATE (0x20) oder ADS_CHASE_REFERRALS_EXTERNAL (0x40).

Der ADSI LDAP-Anbieter unterstützt externe Empfehlungen für Seitensuchen, aber keine untergeordneten Empfehlungen während des Pagings.

Hinweis Da VBScript keine Daten aus einer Typbibliothek lesen kann, verstehen VBScript-Anwendungen die symbolischen Konstanten nicht wie oben definiert. Sie sollten stattdessen die numerischen Konstanten verwenden, um die entsprechenden Flags in Ihren VBScript-Anwendungen festzulegen. Wenn Sie die symbolischen Konstanten als bewährte Programmierpraxis verwenden möchten, sollten Sie explizite Deklarationen solcher Konstanten wie hier in Ihren VBScript-Anwendungen vornehmen.