Status Type

Most SANE operations return a value of type SANE_Status to indicate whether the completion status of the operation. If an operation completes successfully, SANE_STATUS_GOOD is returned. In case of an error, a value is returned that indicates the nature of the problem. The complete list of available status codes is listed in Table 4.1. It is recommended to use function sane_strstatus() to convert status codes into a legible string.

表 4.1: Status Codes

Symbol	Code	Description
SANE_STATUS_GOOD	0	Operation completed succesfully.
SANE_STATUS_UNSUPPORTED	1	Operation is not supported.
SANE_STATUS_CANCELLED	2	Operation was cancelled.
SANE_STATUS_DEVICE_BUSY	3	Device is busy--retry later.
SANE_STATUS_INVAL	4	Data or argument is invalid.
SANE_STATUS_EOF	5	No more data available (end-of-file).
SANE_STATUS_JAMMED	6	Document feeder jammed.
SANE_STATUS_NO_DOCS	7	Document feeder out of documents.
SANE_STATUS_COVER_OPEN	8	Scanner cover is open.
SANE_STATUS_IO_ERROR	9	Error during device I/O.
SANE_STATUS_NO_MEM	10	Out of memory.
SANE_STATUS_ACCESS_DENIED	11	Access to resource has been denied.