Directory Services


The DSOP_INIT_INFO structure contains data required to initialize an object picker dialog box. This structure is used with the IDsObjectPicker::Initialize method.

typedef struct _DSOP_INIT_INFO {
ULONG cbSize;
PCWSTR pwzTargetComputer;
ULONG cDsScopeInfos;
ULONG flOptions;
ULONG cAttributesToFetch;
PCWSTR* apwzAttributeNames; } DSOP_INIT_INFO,


Contains the size, in bytes, of the structure.
Pointer to a null-terminated Unicode string that contains the name of the target computer. The dialog box operates 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.
Specifies the number of elements in the aDsScopeInfos array.
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.
Flags that determine the object picker options. This member can be zero or a combination of one or more of the following flags.
Value Meaning
If this flag is set, the user can select multiple objects. If this flag is not set, the user can select only one object.
If this flag is set and the DSOP_SCOPE_TYPE_TARGET_COMPUTER flag is set in the aDsScopeInfos 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 up-level or down-level domain controller, the DSOP_SCOPE_TYPE_TARGET_COMPUTER flag is ignored and the target computer is not included in the Look in drop-down list.

To save time during initialization, this flag should be set if it is known that the target computer is not a domain controller. However, if the target computer is a domain controller, this flag should not be set because it is better for the user to select domain objects from the domain scope rather than from the domain controller itself.

Contains the number of elements in the apwzAttributeNames array. This member can be zero.
Pointer to an array of null-terminated Unicode strings that contain the names of the attributes to retrieve for each selected object. If cAttributesToFetch is zero, this member is ignored.


Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Objsel.h.

See Also

DSOP_SCOPE_INIT_INFO, IDsObjectPicker::Initialize, Directory Object Picker