CommonDialog.ShowSelectDevice method

Article
05/31/2018

Displays a dialog box that enables the user to select a hardware device for image acquisition.

Syntax

ppResult = .ShowSelectDevice( _
  [ ByVal DeviceType As WiaDeviceType ], _
  [ ByVal AlwaysSelectDevice As VARIANT_BOOL ], _
  [ ByVal CancelError As VARIANT_BOOL ] _
) As HRESULT

Parameters

DeviceType [in, optional]

Type: WiaDeviceType

WiaDeviceType value.

Value	Meaning
UnspecifiedDeviceType	Default. The device type is unknown.

AlwaysSelectDevice [in, optional]

Type: VARIANT_BOOL

Boolean value that indicates whether to always show the select device dialog box.

Value	Meaning
False	Default. Do not show the select device dialog box.
True	Show the select device dialog box.

CancelError [in, optional]

Type: VARIANT_BOOL

Boolean value that indicates whether to generate an error if the user cancels the dialog box.

Value	Meaning
False	Default. Do not generate an error.
True	Generate an error.

Return value

Type: Device**

Returns the selected Device object on success, otherwise returns Nothing.

Remarks

For example code, see Take a Picture in Shared Samples.

Requirements


Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 R2 [desktop apps only]
Header	Wiaaut.h
IDL	Wiaaut.idl