IDsObjectPicker interface

The IDsObjectPicker interface is used by an application to initialize and display an object picker dialog box. To create an instance of this interface, call CoCreateInstance with the CLSID_DsObjectPicker class identifier as shown below.


HRESULT hr = S_OK;
IDsObjectPicker *pDsObjectPicker = NULL;
 
hr = CoCreateInstance(CLSID_DsObjectPicker,
             NULL,
             CLSCTX_INPROC_SERVER,
             IID_IDsObjectPicker,
             (void **) &pDsObjectPicker);

The IDsObjectPicker implemented by the system supports both apartment and free-threading models and is thread safe. In practice, this means that a call to the methods of this interface will block until no other thread of your application is calling any other method on that instance of the interface.

Members

The IDsObjectPicker interface inherits from the IUnknown interface. IDsObjectPicker also has these types of members:

Methods

The IDsObjectPicker interface has these methods.

MethodDescription
Initialize

Initializes the interface with data about the scopes, filters, and options used by the dialog box.

InvokeDialog

Displays the dialog box and returns the user's selections.

 

Remarks

It is acceptable to create and initialize a single instance of the IDsObjectPicker interface and then make multiple calls to InvokeDialog without having to reinitializing the interface.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Objsel.h

DLL

Objsel.dll

IID

IID_IDsObjectPicker is defined as 0c87e64e-3b7a-11d2-b9e0-00c04fd8dbf7

See also

CoCreateInstance
Directory Object Picker

 

 

Show: