ホーム › Networking.ActiveDirectory › ADS_CHASE_REFERRALS_ENUM

ADS_CHASE_REFERRALS_ENUM

列挙型

基底型i4

メンバー 4

名前	10進	16進	説明
ADS_CHASE_REFERRALS_NEVER	0	0x0	クライアントは参照先のサーバーを決して追跡しません。このオプションを設定すると、クライアントは参照の処理において他のサーバーに接続しなくなります。
ADS_CHASE_REFERRALS_SUBORDINATE	32	0x20	クライアントは、ディレクトリツリー内の下位の名前付けコンテキストである下位参照のみを追跡します。たとえば、"DC=Fabrikam,DC=Com" を基点とする検索が要求され、サーバーが結果セットと共に AdbSales サーバー上の "DC=Sales,DC=Fabrikam,DC=Com" への参照を返した場合、クライアントは AdbSales サーバーに接続して検索を継続できます。ADSI LDAP プロバイダーは、ページ検索ではこのフラグを常にオフにします。
ADS_CHASE_REFERRALS_EXTERNAL	64	0x40	クライアントは外部参照を追跡します。たとえば、クライアントがサーバー A に "DC=Fabrikam,DC=Com" の検索を要求したとします。しかし、サーバー A はそのオブジェクトを保持しておらず、独立したサーバー B がそれを所有していることを認識しています。この場合、サーバー A はクライアントをサーバー B へ紹介します。
ADS_CHASE_REFERRALS_ALWAYS	96	0x60	下位参照と外部参照のいずれの種類についても参照が追跡されます。

公式ドキュメント

ADS_CHASE_REFERRALS_ENUM 列挙型は、参照 (referral) の追跡を行うかどうか、および、どのように行うかを指定します。サーバーは、関連するデータの一部または全体を他のサーバーが保持していると判断した場合、結果を取得するためにクライアントを別のサーバーへ紹介することがあります。参照の追跡 (referral chasing) とは、ディレクトリ検索を継続するために、クライアントが参照先のサーバーへ接続する動作のことです。

解説(Remarks)

参照の追跡に関する検索設定を行うには、この列挙型の定数を使用します。この操作は、ADS_SEARCHPREF_INFO 構造体の該当するフィールドに、ADS_CHASE_REFERRALS_ENUM 列挙型および ADS_SEARCHPREF_ENUM 列挙型の要素を割り当てることに相当します。また、この列挙型の値は、コンテナーオブジェクトの配下にあるオブジェクトを列挙する際に参照の追跡を行うかどうかを指定するために、IADsObjectOptions と共に使用することもできます。

IADsNameTranslate インターフェイスは、ChaseReferral プロパティを通じて ADS_CHASE_REFERRALS_ENUM を部分的に実装しています。ChaseReferral プロパティに 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 アプリケーション内でそれらの定数を明示的に宣言してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum ADS_CHASE_REFERRALS_ENUM : int {
    ADS_CHASE_REFERRALS_NEVER = 0,
    ADS_CHASE_REFERRALS_SUBORDINATE = 32,
    ADS_CHASE_REFERRALS_EXTERNAL = 64,
    ADS_CHASE_REFERRALS_ALWAYS = 96
} ADS_CHASE_REFERRALS_ENUM;

public enum ADS_CHASE_REFERRALS_ENUM : int
{
    ADS_CHASE_REFERRALS_NEVER = 0,
    ADS_CHASE_REFERRALS_SUBORDINATE = 32,
    ADS_CHASE_REFERRALS_EXTERNAL = 64,
    ADS_CHASE_REFERRALS_ALWAYS = 96,
}

Public Enum ADS_CHASE_REFERRALS_ENUM As Integer
    ADS_CHASE_REFERRALS_NEVER = 0
    ADS_CHASE_REFERRALS_SUBORDINATE = 32
    ADS_CHASE_REFERRALS_EXTERNAL = 64
    ADS_CHASE_REFERRALS_ALWAYS = 96
End Enum

import enum

class ADS_CHASE_REFERRALS_ENUM(enum.IntEnum):
    ADS_CHASE_REFERRALS_NEVER = 0
    ADS_CHASE_REFERRALS_SUBORDINATE = 32
    ADS_CHASE_REFERRALS_EXTERNAL = 64
    ADS_CHASE_REFERRALS_ALWAYS = 96

// ADS_CHASE_REFERRALS_ENUM
pub const ADS_CHASE_REFERRALS_NEVER: i32 = 0;
pub const ADS_CHASE_REFERRALS_SUBORDINATE: i32 = 32;
pub const ADS_CHASE_REFERRALS_EXTERNAL: i32 = 64;
pub const ADS_CHASE_REFERRALS_ALWAYS: i32 = 96;

// ADS_CHASE_REFERRALS_ENUM
const (
	ADS_CHASE_REFERRALS_NEVER int32 = 0
	ADS_CHASE_REFERRALS_SUBORDINATE int32 = 32
	ADS_CHASE_REFERRALS_EXTERNAL int32 = 64
	ADS_CHASE_REFERRALS_ALWAYS int32 = 96
)

const
  ADS_CHASE_REFERRALS_NEVER = 0;
  ADS_CHASE_REFERRALS_SUBORDINATE = 32;
  ADS_CHASE_REFERRALS_EXTERNAL = 64;
  ADS_CHASE_REFERRALS_ALWAYS = 96;

// ADS_CHASE_REFERRALS_ENUM
pub const ADS_CHASE_REFERRALS_NEVER: i32 = 0;
pub const ADS_CHASE_REFERRALS_SUBORDINATE: i32 = 32;
pub const ADS_CHASE_REFERRALS_EXTERNAL: i32 = 64;
pub const ADS_CHASE_REFERRALS_ALWAYS: i32 = 96;

const
  ADS_CHASE_REFERRALS_NEVER* = 0
  ADS_CHASE_REFERRALS_SUBORDINATE* = 32
  ADS_CHASE_REFERRALS_EXTERNAL* = 64
  ADS_CHASE_REFERRALS_ALWAYS* = 96

enum ADS_CHASE_REFERRALS_ENUM : int {
    ADS_CHASE_REFERRALS_NEVER = 0,
    ADS_CHASE_REFERRALS_SUBORDINATE = 32,
    ADS_CHASE_REFERRALS_EXTERNAL = 64,
    ADS_CHASE_REFERRALS_ALWAYS = 96,
}

#define global ADS_CHASE_REFERRALS_NEVER       0x0
#define global ADS_CHASE_REFERRALS_SUBORDINATE 0x20
#define global ADS_CHASE_REFERRALS_EXTERNAL    0x40
#define global ADS_CHASE_REFERRALS_ALWAYS      0x60