共用方式為


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結構的陣列指標,描述使用者可以從中選取物件的範圍。 這個成員不能是 NULL ,而且數位必須包含至少一個專案,因為對象選擇器無法在沒有至少一個範圍的情況下運作。

flOptions

決定物件選擇器選項的旗標。 這個成員可以是零或下列一或多個旗標的組合。

DSOP_FLAG_MULTISELECT (0x00000001)

如果設定此旗標,用戶可以選取多個物件。 如果未設定此旗標,使用者只能選取一個物件。

DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)

如果已設定此旗標,且 DSOP_SCOPE_TYPE_TARGET_COMPUTER 旗標是在 aDsScopeInfos 陣列中設定,則目標電腦一律會包含在 [ 查看] 下拉式清單中。

如果未設定此旗標,且目標計算機是上層或下層域控制器, 則會忽略DSOP_SCOPE_TYPE_TARGET_COMPUTER 旗標,而且目標計算機不會包含在 [ 查看 ] 下拉式清單中。

若要在初始化期間節省時間,如果已知目標計算機不是域控制器,應該設定此旗標。 不過,如果目標計算機是域控制器,則不應該設定此旗標,因為使用者最好從網域範圍選取網域物件,而不是從域控制器本身選取網域物件。

cAttributesToFetch

包含 apwzAttributeNames 陣列中的項目數目。 這個成員可以是零。

apwzAttributeNames

Null 終止 Unicode 字串陣列的指標,其中包含要針對每個選取物件擷取的屬性名稱。 如果 cAttributesToFetch 為零,則會忽略這個成員。

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
標頭 objsel.h

另請參閱

DSOP_SCOPE_INIT_INFO

目錄物件選擇器

IDsObjectPicker::Initialize