## 概述

PhonePC/2in1Tablet

声明用于发现和连接扫描仪、从扫描仪扫描图像、获取页面扫描进度和设置扫描图像参数等功能的API

**引用文件：** <BasicServicesKit/ohscan.h>

**库：** libohscan.so

**系统能力：** SystemCapability.Print.PrintFramework

**起始版本：** 12

**相关模块：** [OH\_Scan](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan)

## 汇总

PhonePC/2in1Tablet

### 结构体

PhonePC/2in1Tablet

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [Scan\_ScannerDevice](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-scannerdevice) | Scan\_ScannerDevice | 表示扫描仪设备信息 |
| [Scan\_PictureScanProgress](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-picturescanprogress) | Scan\_PictureScanProgress | 表示扫描仪扫描图片的进度 |
| [Scan\_ScannerOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-scanneroptions) | Scan\_ScannerOptions | 表示一个扫描仪的所有参数选项 |

### 枚举

PhonePC/2in1Tablet

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [Scan\_ErrorCode](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) | Scan\_ErrorCode | 定义错误码 |

### 函数

PhonePC/2in1Tablet

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [typedef void (\*Scan\_ScannerDiscoveryCallback)(Scan\_ScannerDevice\*\* devices, int32\_t deviceCount)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_scannerdiscoverycallback) | Scan\_ScannerDiscoveryCallback | 扫描仪设备发现回调，通过[OH\_Scan\_StartScannerDiscovery](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_startscannerdiscovery)注册指针指向的内存将在回调函数结束时释放 |
| [int32\_t OH\_Scan\_Init()](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_init) | - | 此API检查并拉起扫描服务，初始化扫描客户端，并建立与扫描服务的连接 |
| [int32\_t OH\_Scan\_StartScannerDiscovery(Scan\_ScannerDiscoveryCallback callback)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_startscannerdiscovery) | - | 此API开始发现扫描仪，注册回调函数处理发现的扫描仪设备 |
| [int32\_t OH\_Scan\_OpenScanner(const char\* scannerId)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_openscanner) | - | 此API连接到扫描仪设备 |
| [int32\_t OH\_Scan\_CloseScanner(const char\* scannerId)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_closescanner) | - | 此API用于关闭已连接的扫描仪设备 |
| [Scan\_ScannerOptions\* OH\_Scan\_GetScannerParameter(const char\* scannerId, int32\_t\* errorCode)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_getscannerparameter) | - | 此API可用于获取扫描仪可设置的选项列表返回的结构体指针指向的内存会在[OH\_Scan\_Exit](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_exit)时自动释放，每个型号在内存中只会存储一份副本 |
| [int32\_t OH\_Scan\_SetScannerParameter(const char\* scannerId, const int32\_t option, const char\* value)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_setscannerparameter) | - | 此API可用于设置扫描仪的某个选项参数传入的选项和值从[OH\_Scan\_GetScannerParameter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_getscannerparameter)获取 |
| [int32\_t OH\_Scan\_StartScan(const char\* scannerId, bool batchMode)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_startscan) | - | 此API允许扫描仪开始扫描 |
| [int32\_t OH\_Scan\_CancelScan(const char\* scannerId)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_cancelscan) | - | 此API允许扫描仪取消扫描 |
| [int32\_t OH\_Scan\_GetPictureScanProgress(const char\* scannerId, Scan\_PictureScanProgress\* prog)](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_getpicturescanprogress) | - | 此API可获取扫描仪扫描图片的进度。必须传入非空值，扫描进度将写入指针指向的结构体 |
| [int32\_t OH\_Scan\_Exit()](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_exit) | - | 此API可用于退出扫描服务，释放扫描框架内存，并注销扫描仪发现回调 |

## 枚举类型说明

PhonePC/2in1Tablet

### Scan\_ErrorCode

PhonePC/2in1Tablet



```
1. enum Scan_ErrorCode
```

**描述**

定义错误码

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| SCAN\_ERROR\_NONE = 0 | 操作成功 |
| SCAN\_ERROR\_NO\_PERMISSION = 201 | 权限验证失败 |
| SCAN\_ERROR\_INVALID\_PARAMETER = 401 | 参数无效。例如指针为空或字符串为空 |
| SCAN\_ERROR\_GENERIC\_FAILURE = 24300101 | 通用内部错误 |
| SCAN\_ERROR\_RPC\_FAILURE = 24300102 | RPC通信错误 |
| SCAN\_ERROR\_SERVER\_FAILURE = 24300103 | 服务器错误 |
| SCAN\_ERROR\_UNSUPPORTED = 24300104 | 不支持的操作 |
| SCAN\_ERROR\_CANCELED = 24300105 | 操作已取消 |
| SCAN\_ERROR\_DEVICE\_BUSY = 24300106 | 设备繁忙，请稍后重试 |
| SCAN\_ERROR\_INVALID = 24300107 | 数据无效（包括打开时无设备） |
| SCAN\_ERROR\_JAMMED = 24300108 | 文档进纸器卡纸 |
| SCAN\_ERROR\_NO\_DOCS = 24300109 | 文档进纸器缺纸 |
| SCAN\_ERROR\_COVER\_OPEN = 24300110 | 扫描仪盖板打开 |
| SCAN\_ERROR\_IO\_ERROR = 24300111 | 设备I/O错误 |
| SCAN\_ERROR\_NO\_MEMORY = 24300112 | 内存不足 |

## 函数说明

PhonePC/2in1Tablet

### Scan\_ScannerDiscoveryCallback()

PhonePC/2in1Tablet



```
1. typedef void (*Scan_ScannerDiscoveryCallback)(Scan_ScannerDevice** devices, int32_t deviceCount)
```

**描述**

扫描仪设备发现回调，通过[OH\_Scan\_StartScannerDiscovery](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_startscannerdiscovery)注册指针指向的内存将在回调函数结束时释放

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Scan\_ScannerDevice](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-scannerdevice)\*\* devices | 所有发现的扫描仪设备列表 |
| int32\_t deviceCount | 发现的扫描仪数量 |

### OH\_Scan\_Init()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_Init()
```

**描述**

此API检查并拉起扫描服务，初始化扫描客户端，并建立与扫描服务的连接

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描服务成功启动  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误 |

### OH\_Scan\_StartScannerDiscovery()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_StartScannerDiscovery(Scan_ScannerDiscoveryCallback callback)
```

**描述**

此API开始发现扫描仪，注册回调函数处理发现的扫描仪设备

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Scan\_ScannerDiscoveryCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_scannerdiscoverycallback) callback | 扫描仪发现事件的[Scan\_ScannerDiscoveryCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_scannerdiscoverycallback)回调函数 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示成功开始扫描仪搜索  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误 |

### OH\_Scan\_OpenScanner()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_OpenScanner(const char* scannerId)
```

**描述**

此API连接到扫描仪设备

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const char\* scannerId | 用于连接扫描仪的ID |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪成功连接  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误  [SCAN\_ERROR\_DEVICE\_BUSY](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪繁忙  [SCAN\_ERROR\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示输入参数无效  [SCAN\_ERROR\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示与设备通信时发生错误  [SCAN\_ERROR\_NO\_MEMORY](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示可用内存不足 |

### OH\_Scan\_CloseScanner()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_CloseScanner(const char* scannerId)
```

**描述**

此API用于关闭已连接的扫描仪设备

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const char\* scannerId | 用于断开扫描仪连接的ID |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪连接成功关闭  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误  [SCAN\_ERROR\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示输入参数无效 |

### OH\_Scan\_GetScannerParameter()

PhonePC/2in1Tablet



```
1. Scan_ScannerOptions* OH_Scan_GetScannerParameter(const char* scannerId, int32_t* errorCode)
```

**描述**

此API可用于获取扫描仪可设置的选项列表返回的结构体指针指向的内存会在[OH\_Scan\_Exit](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_exit)时自动释放，每个型号在内存中只会存储一份副本

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const char\* scannerId | 用于获取扫描仪参数的ID |
| int32\_t\* errorCode | 如果执行成功，errorCode返回[SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode)，否则返回特定的错误码，参考[Print\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohprint-h#print_errorcode) |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Scan\_ScannerOptions\*](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-scanneroptions) | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示成功获取扫描仪参数选项  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误  [SCAN\_ERROR\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示参数无效 |

### OH\_Scan\_SetScannerParameter()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_SetScannerParameter(const char* scannerId, const int32_t option, const char* value)
```

**描述**

此API可用于设置扫描仪的某个选项参数传入的选项和值从[OH\_Scan\_GetScannerParameter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#oh_scan_getscannerparameter)获取

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const char\* scannerId | 此ID用于设置特定扫描仪的选项 |
| const int32\_t option | 要设置的选项编号。取值范围从0到 optionCount - 1，从[Scan\_ScannerOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-scanneroptions)获取 |
| const char\* value | 要设置的选项值，有效值从ranges获取，从[Scan\_ScannerOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-scanneroptions)获取 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪参数设置成功  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误  [SCAN\_ERROR\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示参数无效 |

### OH\_Scan\_StartScan()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_StartScan(const char* scannerId, bool batchMode)
```

**描述**

此API允许扫描仪开始扫描

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const char\* scannerId | 此ID用于启动指定扫描仪的扫描任务 |
| bool batchMode | 是否以批处理模式启动扫描仪 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪成功启动扫描任务  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误  [SCAN\_ERROR\_JAMMED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示文档进纸器卡纸  [SCAN\_ERROR\_NO\_DOCS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示文档进纸器缺纸  [SCAN\_ERROR\_COVER\_OPEN](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪盖板打开  [SCAN\_ERROR\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示与设备通信时发生错误  [SCAN\_ERROR\_NO\_MEMORY](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示可用内存不足  [SCAN\_ERROR\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示输入参数无效  [SCAN\_ERROR\_DEVICE\_BUSY](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示设备繁忙，应稍后重试操作 |

### OH\_Scan\_CancelScan()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_CancelScan(const char* scannerId)
```

**描述**

此API允许扫描仪取消扫描

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const char\* scannerId | 此ID用于取消指定扫描仪的扫描任务 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪成功取消扫描任务  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示指针为空或字符串为空  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误 |

### OH\_Scan\_GetPictureScanProgress()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_GetPictureScanProgress(const char* scannerId, Scan_PictureScanProgress* prog)
```

**描述**

此API可获取扫描仪扫描图片的进度。必须传入非空值，扫描进度将写入指针指向的结构体

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const char\* scannerId | 用于查询扫描仪图像扫描进度的ID |
| [Scan\_PictureScanProgress](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-picturescanprogress)\* prog | 扫描图片的[Scan\_PictureScanProgress](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-scan-scan-picturescanprogress)，必须为非空值 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪成功查询到扫描图像的进度  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示指针为空或字符串为空  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误  [SCAN\_ERROR\_JAMMED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示文档进纸器卡纸  [SCAN\_ERROR\_NO\_DOCS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示文档进纸器缺纸  [SCAN\_ERROR\_COVER\_OPEN](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描仪盖板打开  [SCAN\_ERROR\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示与扫描仪通信时发生错误  [SCAN\_ERROR\_NO\_MEMORY](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示可用内存不足  [SCAN\_ERROR\_DEVICE\_BUSY](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示设备繁忙，应稍后重试操作 |

### OH\_Scan\_Exit()

PhonePC/2in1Tablet



```
1. int32_t OH_Scan_Exit()
```

**描述**

此API可用于退出扫描服务，释放扫描框架内存，并注销扫描仪发现回调

**系统能力：** SystemCapability.Print.PrintFramework

**需要权限：** ohos.permission.PRINT

**起始版本：** 12

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [SCAN\_ERROR\_NONE](/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描服务成功退出  [SCAN\_ERROR\_NO\_PERMISSION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示无权限使用此接口  [SCAN\_ERROR\_RPC\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示RPC通信错误  [SCAN\_ERROR\_SERVER\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohscan-h#scan_errorcode) 表示扫描过程中发生错误 |