Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Requests to open a session on the device.

Component Version macOS Windows Linux Server iOS SDK
ImageCapture 6.4 ✅ Yes ❌ No ❌ No ❌ No ❌ No
MBS( "ImageCapture.OpenDevice"; Device { ; Wait } )   More


Parameter Description Example Flags
Device The device ID.
Can be zero based index in device list.
Or UUID, Name or persistent ID string.
Wait Pass 1 to wait till complete.
Or pass 0 to return immediately.
Default is 1 to wait.
0 Optional


Returns OK or error.


Requests to open a session on the device.
A client MUST open a session on a device in order to use the device.

If needed closes current device to open new device.
Added 20 seconds timeout for version 8.1.

With ImageCapture.DeviceInfo you can query hasOpenSession later to verify you have a session open.


Open device:

Set Variable [$r; Value:MBS("ImageCapture.OpenDevice"; Images::Device)]
If [MBS("iserror")]
    Show Custom Dialog ["Failed to open"; MBS("Text.RemovePrefix"; $r; "[MBS] ")]
    Exit Script []
End If

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 11st September 2016, last changed 18th April 2024

ImageCapture.MediaFiles - ImageCapture.PDF