sane_open

This function is used to establish a connection to a particular device. The name of the device to be opened is passed in argument name. If the call completes successfully, a handle for the device is returned in *h. As a special case, specifying a zero-length string as the device requests opening the first available device (if there is such a device).

SANE_Status sane_open (SANE_String_Const name, SANE_Handle * h);

This function may fail with one of the following status codes.

SANE_STATUS_DEVICE_BUSY:

The device is currently busy (in use by somebody else).

SANE_STATUS_INVAL:

The device name is not valid.

SANE_STATUS_IO_ERROR:

An error occured while communicating with the device.

SANE_STATUS_NO_MEM:

An insufficent amount of memory is available.

SANE_STATUS_ACCESS_DENIED:

Access to the device has been denied due to insufficient or invalid authentication.