IDsObjectPicker::InvokeDialog method (objsel.h)

The IDsObjectPicker::InvokeDialog method displays a modal object picker dialog box and returns the user selections.

Syntax

HRESULT InvokeDialog(
  HWND        hwndParent,
  IDataObject **ppdoSelections
);

Parameters

hwndParent

Handle to the owner window of the dialog box. This parameter cannot be NULL or the result of the GetDesktopWindow function.

ppdoSelections

Pointer to an IDataObject interface pointer that receives a data object that contains data about the user selections. This data is supplied in the CFSTR_DSOP_DS_SELECTION_LIST data format. This parameter receives NULL if the user cancels the dialog box.

Return value

Returns a standard error code or one of the following values.

Remarks

Before IDsObjectPicker::InvokeDialog is called, the IDsObjectPicker object must be initialized by calling IDsObjectPicker::Initialize. After the IDsObjectPicker object is initialized, InvokeDialog can be called multiple times without reinitializing the interface.

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header objsel.h
DLL Objsel.dll

See also

CFSTR_DSOP_DS_SELECTION_LIST

DS_SELECTION

DS_SELECTION_LIST

Directory Object Picker

IDataObject

IDsObjectPicker