DSOP_INIT_INFO

The DSOP_INIT_INFO structure contains information to initialize an object picker dialog box. You specify this structure when you call the IDsObjectPicker::Initialize method.

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;

Members

cbSize

Specifies the size, in bytes, of the structure.

pwzTargetComputer

Pointer to a null-terminated Unicode string containing the name of the target computer. The dialog box behaves as if it is running on the target computer, using the target computer to determine the joined domain and enterprise. If this value is NULL, the target computer is the local computer.

cDsScopeInfos

Specifies the number of elements in the aDsScopeInfos array. Must be at least 1.

aDsScopeInfos

Pointer to an array of DSOP_SCOPE_INIT_INFO structures that describe the scopes from which the user can select objects. This member cannot be NULL and the array must contain at least one element because the object picker cannot operate without at least one scope.

flOptions

Flags that determine the object picker options. This member can specify the following flag.

Value	Meaning
DSOP_FLAG_MULTISELECT	If this flag is set, the user can select multiple objects. If this flag is not set, the user can select only one object.
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK	If this flag is set and the DSOP_SCOPE_TYPE_TARGET_COMPUTER flag is set in the DSOP_SCOPE_INIT_INFO array, the target computer is always included in the Look in drop-down list. If this flag is not set and the target computer is an uplevel or downlevel domain controller, the DSOP_SCOPE_TYPE_TARGET_COMPUTER flag is ignored and the target computer is not included in the Lookin in drop-down list. You should set this flag if you know the target computer is not a domain controller, to save time during initialization. However, if the target computer is a domain controller, you should typically not set this flag because it is better for the user to select domain objects from the domain scope rather than from the domain controller itself.

cAttributesToFetch

Specifies the number of elements in the apwzAttributeNames array. This member can be zero.

apwzAttributeNames

Pointer to an array of null-terminated Unicode strings that name the attributes to retrieve for each selected object. If cAttributesToFetch is zero, this member is ignored.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Objsel.h.

See Also

DSOP_SCOPE_INIT_INFO, IDsObjectPicker::Initialize, Object Picker Dialog Box Overview, Object Picker Dialog Box Structures