IDsObjectPicker::Initialize

The Initialize method initializes the IDsObjectPicker interface with information about the scopes, filters, and options used by the object picker dialog box.

HRESULT Initialize(
  PDSOP_INIT_INFO pInitInfo
);

Parameters

pInitInfo

Pointer to a DSOP_INIT_INFO structure containing the initialization information.

Return Values

If the method is successful, the return value is S_OK.

If an error occurs, the return value is a COM error code. For more information, see Error Handling.

Remarks

You can make multiple Initialize calls for a given instance of the IDsObjectPicker interface. The most recent Initialize call determines the scopes, filters, and options used the next time the object picker dialog box is displayed.

You can also create and initialize an instance of the IDsObjectPicker interface once, and then make multiple InvokeDialog calls to display the dialog box multiple times without reinitializing it.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Objsel.h.
  Library: Included as a resource in Objsel.dll.

See Also

Active Directory Display Interfaces, DSOP_INIT_INFO, IDsObjectPicker, Object Picker Dialog Box Interfaces, Object Picker Dialog Box Overview