Share via

ADS_CHASE_REFERRALS_ENUM列挙 (iads.h)

  • [アーティクル]

ADS_CHASE_REFERRALS_ENUM列挙では、紹介の追跡が行われるかどうかを指定し、その方法を指定します。 サーバーは、他のサーバーが関連するデータを一部または全体として保持していると判断した場合、クライアントを別のサーバーに参照して結果を取得する場合があります。 紹介の追跡は、参照先サーバーに接続してディレクトリ検索を続行するためにクライアントによって実行されるアクションです。

構文

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;

定数

 
ADS_CHASE_REFERRALS_NEVER
値: 0
クライアントは、参照されるサーバーを追跡しないでください。 このオプションを設定すると、クライアントは参照を処理するために他のサーバーには接続しません。
ADS_CHASE_REFERRALS_SUBORDINATE
値: 0x20
クライアントは、ディレクトリ ツリー内の下位の名前付けコンテキストである下位参照のみを追跡します。 たとえば、ベース検索で "DC=Fabrikam,DC=Com" が要求され、サーバーが AdbSales サーバーで結果セットと "DC=Sales,DC=Fabrikam,DC=Com" の紹介を返した場合、クライアントは AdbSales サーバーに接続して検索を続行できます。 ADSI LDAP プロバイダーは、ページング検索に対しては常にこのフラグをオフにします。
ADS_CHASE_REFERRALS_EXTERNAL
値: 0x40
クライアントは外部の紹介を追跡します。 たとえば、クライアントは"DC=Fabrikam,DC=Com" の検索を実行するようにサーバー A に要求します。 ただし、サーバー A には オブジェクトが含まれていませんが、独立したサーバー B がオブジェクトを所有していることを認識しています。 次に、クライアントをサーバー B に参照します。
ADS_CHASE_REFERRALS_ALWAYS
紹介は、下位または外部の型に対して追跡されます。

注釈

この列挙の定数を使用して、紹介追跡の検索設定を設定します。 アクションは、 ADS_CHASE_REFERRALS_ENUMおよびADS_SEARCHPREF_ENUM 列挙の要素を使用して、 ADS_SEARCHPREF_INFO 構造体の適切なフィールド を 割り当てることに相当します。 この列挙の値を IADsObjectOptions と共に使用して、コンテナー オブジェクトの下でオブジェクトを列挙するときに参照の追跡を行う必要があるかどうかを指定することもできます。

IADsNameTranslate インターフェイスには、ChaseReferral プロパティを介したADS_CHASE_REFERRALS_ENUMの部分的な実装があります。 ChaseReferral プロパティが 0 (0) に設定されている場合は、ADS_CHASE_REFERRALS_NEVER (0) を指定する場合と同じです。 0 以外の値を使用する場合は、 ADS_CHASE_REFERRALS_ALWAYS (0x60 ) を指定する場合と同じです。 IADsNameTranslate では、 ADS_CHASE_REFERRALS_SUBORDINATE (0x20) または ADS_CHASE_REFERRALS_EXTERNAL (0x40) オプションは実装されません。

ADSI LDAP プロバイダーは、ページ検索の外部参照をサポートしますが、ページング中の下位参照はサポートしていません。

メモ VBScript はタイプ ライブラリからデータを読み取ることができないため、VBScript アプリケーションでは上記で定義されているシンボリック定数を理解できません。 代わりに数値定数を使用して、VBScript アプリケーションで適切なフラグを設定する必要があります。 シンボリック定数を適切なプログラミングプラクティスとして使用する場合は、VBScript アプリケーションで、ここで行うような定数を明示的に宣言する必要があります。
 

要件

要件 値
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
Header iads.h

こちらもご覧ください

ADSI 列挙

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO

IADsNameTranslate

IADsObjectOptions