DSOP_SCOPE_INIT_INFO 構造体 (objsel.h)
DSOP_SCOPE_INIT_INFO構造体は、同じ属性を持つ 1 つ以上のスコープ型を記述します。 スコープの種類は、ドメイン、コンピューター、グローバル カタログなど、ユーザーがオブジェクトを選択できる場所の種類です。 この構造体は、IDsObjectPicker::Initialize を呼び出すときにDSOP_INIT_INFOと共に使用されます。
構文
typedef struct _DSOP_SCOPE_INIT_INFO {
ULONG cbSize;
ULONG flType;
ULONG flScope;
DSOP_FILTER_FLAGS FilterFlags;
PCWSTR pwzDcName;
PCWSTR pwzADsPath;
HRESULT hr;
} DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;
メンバー
cbSize
構造体のサイズ (バイト単位) を格納します。
flType
この構造体で説明されているスコープの種類を示すフラグ。 指定したすべてのスコープで同じ設定が使用されている場合は、複数のスコープの種類を組み合わせることができます。 このメンバーには、次のフラグを組み合わせて使用できます。
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
DSOP_INIT_INFO構造体の pwzTargetComputer メンバーによって指定されたコンピューター。
ターゲット コンピューターが上位レベルまたは下位レベルのドメイン コントローラーの場合、DSOP_INIT_INFO構造体のflOptions メンバーに DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK フラグが設定されていない限り、このフラグは無視されます。
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
ターゲット コンピューターが参加している上位レベルのドメイン。 このフラグが設定されている場合は、 pwzDcName メンバーを使用して、参加しているドメイン内のドメイン コントローラーの名前を指定します。
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
ターゲット コンピューターが参加している下位レベルのドメイン。
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
ターゲット コンピューターが属する企業内のすべてのドメイン。 DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN スコープが指定されている場合、DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN スコープは、参加しているドメインを除くエンタープライズ内のすべてのドメインを表します。
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
エンタープライズ内のすべてのドメインのオブジェクトを含むスコープ。 エンタープライズには、上位レベルのドメインのみを含めることができます。
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
エンタープライズの外部にあるが、ターゲット コンピューターが参加しているドメインによって信頼されているすべての上位ドメイン。
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
エンタープライズの外部にあるすべての下位レベルのドメイン。ただし、ターゲット コンピューターが参加しているドメインによって信頼されます。
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
ターゲット コンピューターが参加しているワークグループ。 ターゲット コンピューターがドメインに参加していない場合にのみ適用されます。
ワークグループから選択できるオブジェクトの種類は、コンピューターのみです。
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
ユーザーが上位レベルのスコープを入力できるようにします。 どちらのDSOP_SCOPE_TYPE_USER_ENTERED_* 型も指定されていない場合、ダイアログ ボックスはユーザーを [検索先] ドロップダウン リストのスコープに制限します。
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
ユーザーが下位レベルのスコープを入力できるようにします。
flScope
このスコープから選択したオブジェクトの ADsPath を返すために使用される形式を示すフラグ。 flScope メンバーは、[検索先] ドロップダウン リストに表示される初期スコープを示すこともできます。 このメンバーには、次のフラグを組み合わせて使用できます。
LDAP およびグローバル カタログ (GC) パスは、WinNT ADsPath 構文に変換できます。 GC パスは LDAP 形式に変換できます。 objectSid 属性を持つ WinNT オブジェクトは、 DSOP_SCOPE_FLAG_WANT_SID_PATHまたはDSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP フラグを指定した場合に LDAP 形式 に 変換できます。 他の変換は有効です。
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
この構造で説明されているスコープは、最初は [検索先] ドロップダウン リスト で 選択されます。 このフラグを指定できるスコープは 1 つだけです。 このフラグを指定するスコープがない場合、最初のスコープは、 IDsObjectPicker::Initialize メソッドに渡されるスコープの配列で最初に正常に作成されたスコープです。
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
ADsPaths は、WinNT プロバイダーを使用するように変換されます。 詳細については、「 WinNT ADsPath」を参照してください。
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
ADsPaths は、LDAP プロバイダーを使用するように変換されます。 詳細については、「 LDAP ADsPath」を参照してください。
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
このスコープから選択したオブジェクトの ADsPath は、GC プロバイダーを使用するように変換されます。
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
objectSid 属性を持つ ADsPaths は、LDAP://< SID=x という形式に変換されます。ここで、>x は objectSid 属性値の 16 進数を表します。
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
ダウンレベルの既知の SID オブジェクトの ADsPath は、このフラグが指定されていない限り空の文字列です (例: DSOP_DOWNLEVEL_FILTER_INTERACTIVE)。 このフラグを指定すると、パスの形式が
AUTHORITY/Interactive または WinNT://Creator 所有者を WinNT://NT します。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
スコープ フィルターにユーザーが含まれている場合は、ダイアログで [ユーザー チェック] ボックスを選択します。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
スコープ フィルターにグループが含まれている場合は、ダイアログで [グループ チェック] ボックスを選択します。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
スコープ フィルターにコンピューターが含まれている場合は、ダイアログボックスの [コンピューターチェック] ボックスを選択します。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
スコープ フィルターに連絡先が含まれている場合は、ダイアログの [連絡先チェック] ボックスを選択します。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
スコープ フィルターにサービス アカウントが含まれている場合は、ダイアログで [サービス アカウント] ボックスと [グループ管理サービス アカウント] チェック ボックスを選択します。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
スコープ フィルターにパスワード設定オブジェクトが含まれている場合は、ダイアログで [パスワード設定オブジェクト] チェック ボックスを選択します。
FilterFlags
このスコープまたはスコープに対してユーザーに表示されるオブジェクトの種類を示す DSOP_FILTER_FLAGS構造体が 含まれます。
pwzDcName
ターゲット コンピューターが参加しているドメインのドメイン コントローラーの名前を含む、null で終わる Unicode 文字列へのポインター。 このメンバーは、 flType メンバーに DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN フラグが含まれている場合にのみ使用されます。 そのフラグが設定されていない場合、 pwzDcName はNULL である必要があります。
このメンバーは、DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN フラグが指定されている場合でも NULL にすることができます。この場合、ダイアログ ボックスはドメイン コントローラーを検索します。 このメンバーを使用すると、マルチマスター ドメイン内の特定のドメイン コントローラーに名前を付けられます。 たとえば、管理アプリケーションがマルチマスター ドメインのドメイン コントローラーに変更を加えた後、他のドメイン コントローラーで変更がレプリケートされる前にオブジェクト ピッカー ダイアログ ボックスを開く場合があります。
pwzADsPath
予約; は NULL である必要があります。
hr
特定のスコープの状態を示す HRESULT 値が含まれます。 IDsObjectPicker::Initialize メソッドによって、この構造体で指定されたスコープ (スコープ) が正常に作成された場合、hr にはS_OKが含まれます。 それ以外の場合は、 hr にエラー コードが含まれます。
IDsObjectPicker::Initialize がS_OKを返す場合、指定されたすべてのDSOP_SCOPE_INIT_INFO構造体の hr メンバーにもS_OKが含まれます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| Header | objsel.h |