ホーム › Networking.ActiveDirectory › ADS_SCOPEENUM

ADS_SCOPEENUM

列挙型

基底型i4

メンバー 3

名前	10進	16進	説明
ADS_SCOPE_BASE	0	0x0	検索をベースオブジェクトのみに限定します。結果に含まれるオブジェクトは最大で 1 個です。
ADS_SCOPE_ONELEVEL	1	0x1	ベースオブジェクトを除き、その直下の子オブジェクト 1 階層のみを検索します。
ADS_SCOPE_SUBTREE	2	0x2	すべての子オブジェクトとベースオブジェクト自体を含む、サブツリー全体を検索します。

公式ドキュメント

ADS_SCOPEENUM 列挙型は、ディレクトリ検索のスコープを指定します。

解説(Remarks)

検索スコープを明示的に設定しない場合、既定値は ADS_SCOPE_SUBTREE です。

VBScript はタイプライブラリからデータを読み取れないため、VBScript アプリケーションでは上記で定義されているシンボル定数は認識されません。VBScript アプリケーションで適切なフラグを設定するには、代わりに数値の定数を使用してください。良いプログラミング手法としてシンボル定数を使用する場合は、ここで示すように、VBScript アプリケーション内でそれらの定数を明示的に宣言してください。

例

検索スコープは、クライアントが指定できる検索設定の 1 つです。次のコード例では、ADS_SEARCHPREF_INFO 構造体と、ADS_SEARCHPREF_ENUM およびこの列挙型で定義されている要素を使用して、これを行う方法を示します。

ADS_SEARCHPREF_INFO prefInfo;
prefInfo.dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
prefInfo.vValue.dwType = ADSTYPE_INTEGER;
prefInfo.vValue.Integer = ADS_SCOPE_SUBTREE;

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_SCOPEENUM : int {
    ADS_SCOPE_BASE = 0,
    ADS_SCOPE_ONELEVEL = 1,
    ADS_SCOPE_SUBTREE = 2
} ADS_SCOPEENUM;

public enum ADS_SCOPEENUM : int
{
    ADS_SCOPE_BASE = 0,
    ADS_SCOPE_ONELEVEL = 1,
    ADS_SCOPE_SUBTREE = 2,
}

Public Enum ADS_SCOPEENUM As Integer
    ADS_SCOPE_BASE = 0
    ADS_SCOPE_ONELEVEL = 1
    ADS_SCOPE_SUBTREE = 2
End Enum

import enum

class ADS_SCOPEENUM(enum.IntEnum):
    ADS_SCOPE_BASE = 0
    ADS_SCOPE_ONELEVEL = 1
    ADS_SCOPE_SUBTREE = 2

// ADS_SCOPEENUM
pub const ADS_SCOPE_BASE: i32 = 0;
pub const ADS_SCOPE_ONELEVEL: i32 = 1;
pub const ADS_SCOPE_SUBTREE: i32 = 2;

// ADS_SCOPEENUM
const (
	ADS_SCOPE_BASE int32 = 0
	ADS_SCOPE_ONELEVEL int32 = 1
	ADS_SCOPE_SUBTREE int32 = 2
)

const
  ADS_SCOPE_BASE = 0;
  ADS_SCOPE_ONELEVEL = 1;
  ADS_SCOPE_SUBTREE = 2;

// ADS_SCOPEENUM
pub const ADS_SCOPE_BASE: i32 = 0;
pub const ADS_SCOPE_ONELEVEL: i32 = 1;
pub const ADS_SCOPE_SUBTREE: i32 = 2;

const
  ADS_SCOPE_BASE* = 0
  ADS_SCOPE_ONELEVEL* = 1
  ADS_SCOPE_SUBTREE* = 2

enum ADS_SCOPEENUM : int {
    ADS_SCOPE_BASE = 0,
    ADS_SCOPE_ONELEVEL = 1,
    ADS_SCOPE_SUBTREE = 2,
}

#define global ADS_SCOPE_BASE     0x0
#define global ADS_SCOPE_ONELEVEL 0x1
#define global ADS_SCOPE_SUBTREE  0x2