DSOP_INIT_INFO構造体 (objsel.h)
DSOP_INIT_INFO構造体には、オブジェクト ピッカー ダイアログ ボックスを初期化するために必要なデータが含まれています。 この構造体は、 IDsObjectPicker::Initialize メソッドと共に使用されます。
構文
typedef struct _DSOP_INIT_INFO {
ULONG cbSize;
PCWSTR pwzTargetComputer;
ULONG cDsScopeInfos;
PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
ULONG flOptions;
ULONG cAttributesToFetch;
PCWSTR *apwzAttributeNames;
} DSOP_INIT_INFO, *PDSOP_INIT_INFO;
メンバー
cbSize
構造体のサイズをバイト単位で格納します。
pwzTargetComputer
ターゲット コンピューターの名前を含む null で終わる Unicode 文字列へのポインター。 このダイアログ ボックスは、ターゲット コンピューター上で実行されているかのように動作し、ターゲット コンピューターを使用して参加しているドメインとエンタープライズを特定します。 この値が NULL の場合、ターゲット コンピューターはローカル コンピューターです。
cDsScopeInfos
aDsScopeInfos 配列内の要素の数を指定します。
aDsScopeInfos
ユーザーがオブジェクトを選択できるスコープを記述する DSOP_SCOPE_INIT_INFO 構造体の配列へのポインター。 オブジェクト ピッカーは少なくとも 1 つのスコープなしでは動作できないため、このメンバーは NULL にすることはできません。配列には少なくとも 1 つの要素が含まれている必要があります。
flOptions
オブジェクト ピッカー オプションを決定するフラグ。 このメンバーは、0 または次のフラグの 1 つ以上の組み合わせにすることができます。
DSOP_FLAG_MULTISELECT (0x00000001)
このフラグが設定されている場合、ユーザーは複数のオブジェクトを選択できます。 このフラグが設定されていない場合、ユーザーは 1 つのオブジェクトのみを選択できます。
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)
このフラグが設定され、 DSOP_SCOPE_TYPE_TARGET_COMPUTER フラグが aDsScopeInfos 配列に設定されている場合、ターゲット コンピューターは常に [検索先] ドロップダウン リスト に 含まれます。
このフラグが設定されておらず、ターゲット コンピューターが上位レベルまたは下位レベルのドメイン コントローラーである場合、 DSOP_SCOPE_TYPE_TARGET_COMPUTER フラグは無視され、ターゲット コンピューターは [検索先] ドロップダウン リスト に 含まれません。
初期化中に時間を節約するために、ターゲット コンピューターがドメイン コントローラーではないことが判明している場合は、このフラグを設定する必要があります。 ただし、ターゲット コンピューターがドメイン コントローラーの場合は、ドメイン コントローラー自体からではなく、ドメイン スコープからドメイン オブジェクトを選択する方がユーザーに適しているため、このフラグを設定しないでください。
cAttributesToFetch
apwzAttributeNames 配列内の要素の数を格納します。 このメンバーは 0 にすることができます。
apwzAttributeNames
選択したオブジェクトごとに取得する属性の名前を含む、null で終わる Unicode 文字列の配列へのポインター。 cAttributesToFetch が 0 の場合、このメンバーは無視されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| Header | objsel.h |