IWiaUIExtension2::DeviceDialog method

Provides a custom user interface that replaces the default system user interface.

Syntax

HRESULT DeviceDialog(
  [in] PDEVICEDIALOGDATA2 *pDeviceDialogData
);

Parameters

pDeviceDialogData [in]

Type: PDEVICEDIALOGDATA2*

Points to a DEVICEDIALOGDATA2 structure that contains all of the data needed to implement the device dialog.

Return value

Type: HRESULT

If the method succeeds, it returns S_OK. If the user cancels the dialog, the method returns S_FALSE. If the method fails, it returns an appropriate error code. The following table shows some of the possible return status codes.

Error code Description
E_INVALIDARG Parameter pDeviceDialogData is NULL.
E_NOTIMPL The method is not implemented.

 

Remarks

If you implement the IWiaUIExtension2 interface and do not want to replace the system user interface, this method must still be implemented, but it should do nothing more than return E_NOTIMPL.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Wiadevd.h