IDsObjectPicker::InvokeDialog method (objsel.h)

Article
02/22/2024

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

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