openharmony 鸿蒙 capi-ohprint-h

2026-08-25 浏览 (1)

ohprint.h

概述

声明用于发现和连接打印机、通过打印机打印文件、查询已添加打印机列表及其内部打印机信息等功能的 API。

引用文件： <BasicServicesKit/ohprint.h>

库： libohprint.so

系统能力： SystemCapability.Print.PrintFramework

起始版本： 12

相关模块： OH_Print

汇总

结构体

名称typedef关键字描述
Print_StringListPrint_StringList表示字符串列表。
Print_PropertyPrint_Property表示打印机属性。
Print_PropertyListPrint_PropertyList打印机属性列表。
Print_ResolutionPrint_Resolution表示以 dpi 为单位的打印分辨率。
Print_MarginPrint_Margin表示打印边距。
Print_PageSizePrint_PageSize表示纸张尺寸信息。
Print_PrinterCapabilityPrint_PrinterCapability表示打印机能力。
Print_DefaultValuePrint_DefaultValue表示当前属性。
Print_PrinterInfoPrint_PrinterInfo表示打印机信息。
Print_PrintJobPrint_PrintJob表示打印任务结构体。
Print_RangePrint_Range表示打印范围结构体。
Print_PrintAttributesPrint_PrintAttributes表示打印属性结构体。
Print_PrintDocCallbackPrint_PrintDocCallback表示打印文档状态回调结构体。

枚举

名称typedef关键字描述
Print_ErrorCodePrint_ErrorCode定义错误码。
Print_PrinterStatePrint_PrinterState表示打印机状态。
Print_DiscoveryEventPrint_DiscoveryEvent表示打印机发现事件。
Print_PrinterEventPrint_PrinterEvent表示打印机变更事件。
Print_DuplexModePrint_DuplexMode表示双面打印模式。
Print_ColorModePrint_ColorMode表示色彩模式。
Print_OrientationModePrint_OrientationMode表示方向模式。
Print_QualityPrint_Quality表示打印质量。
Print_DocumentFormatPrint_DocumentFormat表示文档的 MIME 媒体类型。
Print_JobDocAdapterStatePrint_JobDocAdapterState表示打印任务文档适配器状态。
OH_Print_JobStateOH_Print_JobState表示打印任务状态。

函数

名称typedef关键字描述
typedef void(*Print_WriteResultCallback)(const char *jobId, uint32_t code)Print_WriteResultCallback写文件结果回调。
typedef void(*Print_OnStartLayoutWrite)(const char *jobId, uint32_t fd, const Print_PrintAttributes *oldAttrs, const Print_PrintAttributes *newAttrs, Print_WriteResultCallback writeCallback)Print_OnStartLayoutWrite打印开始布局回调。
typedef void(*Print_OnJobStateChanged)(const char *jobId, uint32_t state)Print_OnJobStateChanged打印任务状态回调。
typedef void (*Print_PrinterDiscoveryCallback)(Print_DiscoveryEvent event, const Print_PrinterInfo *printerInfo)Print_PrinterDiscoveryCallback打印机发现回调。
typedef void (*Print_PrinterChangeCallback)(Print_PrinterEvent event, const Print_PrinterInfo *printerInfo)Print_PrinterChangeCallback打印机变更回调。
Print_ErrorCode OH_Print_Init()-此 API 检查并拉起打印服务，初始化打印客户端，并建立与打印服务的连接。
Print_ErrorCode OH_Print_Release()-此 API 关闭与打印服务的连接，解散先前的回调，并释放打印客户端资源。
Print_ErrorCode OH_Print_StartPrinterDiscovery(Print_PrinterDiscoveryCallback callback)-此 API 开始发现打印机。
Print_ErrorCode OH_Print_StopPrinterDiscovery()-此 API 停止发现打印机。
Print_ErrorCode OH_Print_ConnectPrinter(const char *printerId)-此 API 使用打印机 ID 连接打印机。
Print_ErrorCode OH_Print_StartPrintJob(const Print_PrintJob *printJob)-此 API 开始发起打印任务。
Print_ErrorCode OH_Print_RegisterPrinterChangeListener(Print_PrinterChangeCallback callback)-此 API 注册打印机变更回调。
void OH_Print_UnregisterPrinterChangeListener()-此 API 注销打印机变更回调。
Print_ErrorCode OH_Print_QueryPrinterList(Print_StringList *printerIdList)-此 API 查询已添加的打印机列表。
void OH_Print_ReleasePrinterList(Print_StringList *printerIdList)-此 API 释放用于查询的打印机列表内存。
Print_ErrorCode OH_Print_QueryPrinterInfo(const char *printerId, Print_PrinterInfo **printerInfo)-此 API 根据打印机 ID 查询打印机信息。
void OH_Print_ReleasePrinterInfo(Print_PrinterInfo *printerInfo)-此 API 释放用于查询的打印机信息内存。
Print_ErrorCode OH_Print_LaunchPrinterManager()-此 API 启动系统的打印机管理窗口。
Print_ErrorCode OH_Print_QueryPrinterProperties(const char *printerId, const Print_StringList *propertyKeyList, Print_PropertyList *propertyList)-此 API 根据属性关键字列表查询对应的打印机属性值。
void OH_Print_ReleasePrinterProperties(Print_PropertyList *propertyList)-此 API 释放用于查询的属性列表内存。
Print_ErrorCode OH_Print_UpdatePrinterProperties(const char *printerId, const Print_PropertyList *propertyList)-此 API 根据属性键值对列表设置打印机属性。
Print_ErrorCode OH_Print_RestorePrinterProperties(const char *printerId, const Print_StringList *propertyKeyList)-此 API 根据属性关键字列表将打印机属性恢复为默认设置。
Print_ErrorCode OH_Print_StartPrintByNative(const char *printJobName, Print_PrintDocCallback printDocCallback, void *context)-此 API 提供启动打印对话框的能力。
typedef void(*OH_Print_OnJobStateChanged)(const char *jobId, OH_Print_JobState state)-打印任务状态回调。
Print_ErrorCode OH_Print_StartPrintWithJobStateCallback(const Print_PrintJob *printJob, OH_Print_OnJobStateChanged jobStateChangedCb)-此API下发打印任务，并附带任务状态变更回调功能。

枚举类型说明

Print_ErrorCode

enum Print_ErrorCode

描述

定义错误码。

起始版本： 12

枚举项描述
PRINT_ERROR_NONE = 0操作成功。
PRINT_ERROR_NO_PERMISSION = 201权限校验失败。
PRINT_ERROR_INVALID_PARAMETER = 401参数无效。
PRINT_ERROR_GENERIC_FAILURE = 24300001通用内部错误。
PRINT_ERROR_RPC_FAILURE = 24300002RPC 通信错误。
PRINT_ERROR_SERVER_FAILURE = 24300003服务端错误。
PRINT_ERROR_INVALID_EXTENSION = 24300004无效的扩展。
PRINT_ERROR_INVALID_PRINTER = 24300005无效的打印机。
PRINT_ERROR_INVALID_PRINT_JOB = 24300006无效的打印任务。
PRINT_ERROR_FILE_IO = 24300007读写文件失败。
PRINT_ERROR_UNKNOWN = 24300255未知错误。

Print_PrinterState

enum Print_PrinterState

描述

表示打印机状态。

起始版本： 12

枚举项描述
PRINTER_IDLE打印机空闲。
PRINTER_BUSY打印机忙。
PRINTER_UNAVAILABLE打印机不可用。

Print_DiscoveryEvent

enum Print_DiscoveryEvent

描述

表示打印机发现事件。

起始版本： 12

枚举项描述
PRINTER_DISCOVERED = 0发现打印机。
PRINTER_LOST = 1丢失打印机。
PRINTER_CONNECTING = 2正在连接打印机。
PRINTER_CONNECTED = 3打印机已连接。

Print_PrinterEvent

enum Print_PrinterEvent

描述

表示打印机变更事件。

起始版本： 12

枚举项描述
PRINTER_ADDED = 0打印机已添加。
PRINTER_DELETED = 1打印机已删除。
PRINTER_STATE_CHANGED = 2打印机状态已变更。
PRINTER_INFO_CHANGED = 3打印机信息已变更。

Print_DuplexMode

enum Print_DuplexMode

描述

表示双面打印模式。

起始版本： 12

枚举项描述
DUPLEX_MODE_ONE_SIDED = 0单面模式。
DUPLEX_MODE_TWO_SIDED_LONG_EDGE = 1长边翻转双面模式。
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE = 2短边翻转双面模式。

Print_ColorMode

enum Print_ColorMode

描述

表示色彩模式。

起始版本： 12

枚举项描述
COLOR_MODE_MONOCHROME = 0黑白模式。
COLOR_MODE_COLOR = 1彩色模式。
COLOR_MODE_AUTO = 2自动模式。

Print_OrientationMode

enum Print_OrientationMode

描述

表示方向模式。

起始版本： 12

枚举项描述
ORIENTATION_MODE_PORTRAIT = 0纵向模式。
ORIENTATION_MODE_LANDSCAPE = 1横向模式。
ORIENTATION_MODE_REVERSE_LANDSCAPE = 2反向横向模式。
ORIENTATION_MODE_REVERSE_PORTRAIT = 3反向纵向模式。
ORIENTATION_MODE_NONE = 4未指定。

Print_Quality

enum Print_Quality

描述

表示打印质量。

起始版本： 12

枚举项描述
PRINT_QUALITY_DRAFT = 3草稿质量模式
PRINT_QUALITY_NORMAL = 4正常质量模式
PRINT_QUALITY_HIGH = 5高质量模式

Print_DocumentFormat

enum Print_DocumentFormat

描述

表示文档的 MIME 媒体类型。

起始版本： 12

枚举项描述
DOCUMENT_FORMAT_AUTOMIME 类型：application/octet-stream。
DOCUMENT_FORMAT_JPEGMIME 类型：image/jpeg。
DOCUMENT_FORMAT_PDFMIME 类型：application/pdf。
DOCUMENT_FORMAT_POSTSCRIPTMIME 类型：application/postscript。
DOCUMENT_FORMAT_TEXTMIME 类型：text/plain。

Print_JobDocAdapterState

enum Print_JobDocAdapterState

描述

表示打印任务文档适配器状态。

起始版本： 13

枚举项描述
PRINT_DOC_ADAPTER_PREVIEW_ABILITY_DESTROY = 0打印任务预览能力销毁。
PRINT_DOC_ADAPTER_PRINT_TASK_SUCCEED = 1打印任务成功。
PRINT_DOC_ADAPTER_PRINT_TASK_FAIL = 2打印任务失败。
PRINT_DOC_ADAPTER_PRINT_TASK_CANCEL = 3打印任务取消。
PRINT_DOC_ADAPTER_PRINT_TASK_BLOCK = 4打印任务阻塞。
PRINT_DOC_ADAPTER_PREVIEW_ABILITY_DESTROY_FOR_CANCELED = 5因取消导致的打印任务预览能力销毁。
PRINT_DOC_ADAPTER_PREVIEW_ABILITY_DESTROY_FOR_STARTED = 6因启动导致的打印任务预览能力销毁。

OH_Print_JobState

enum OH_Print_JobState

描述

表示打印任务状态。

起始版本： 24

名称值说明
OH_PRINT_JOB_SUCCEED0打印任务成功。
OH_PRINT_JOB_FAIL1打印任务失败。
OH_PRINT_JOB_CANCEL2打印任务取消。
OH_PRINT_JOB_BLOCK3打印任务阻塞。

函数说明

Print_WriteResultCallback()

typedef void(*Print_WriteResultCallback)(const char *jobId, uint32_t code)

描述

写文件结果回调。

起始版本： 13

参数：

参数项描述
const char *jobId打印任务的 ID。
uint32_t code写文件的结果。

Print_OnStartLayoutWrite()

typedef void(*Print_OnStartLayoutWrite)(const char *jobId, uint32_t fd, const Print_PrintAttributes *oldAttrs, const Print_PrintAttributes *newAttrs, Print_WriteResultCallback writeCallback)

描述

打印开始布局回调。

起始版本： 13

参数：

参数项描述
const char *jobId打印任务的 ID。
uint32_t fd待写入的文件描述符。
const Print_PrintAttributes *oldAttrs上一次的属性。
const Print_PrintAttributes *newAttrs当前的属性。
Print_WriteResultCallback writeCallback写文件结果回调。

Print_OnJobStateChanged()

typedef void(*Print_OnJobStateChanged)(const char *jobId, uint32_t state)

描述

打印任务状态回调。

起始版本： 13

参数：

参数项描述
const char *jobId打印任务的 ID。
uint32_t state当前打印任务的状态。

Print_PrinterDiscoveryCallback()

typedef void (*Print_PrinterDiscoveryCallback)(Print_DiscoveryEvent event, const Print_PrinterInfo *printerInfo)

描述

打印机发现回调。

起始版本： 12

参数：

参数项描述
Print_DiscoveryEvent event打印机发现过程中的发现事件。
const Print_PrinterInfo *printerInfo发现事件发生时的打印机信息。

Print_PrinterChangeCallback()

typedef void (*Print_PrinterChangeCallback)(Print_PrinterEvent event, const Print_PrinterInfo *printerInfo)

描述

打印机变更回调。

起始版本： 12

参数：

参数项描述
Print_PrinterEvent event打印服务运行期间的打印机变更事件。
const Print_PrinterInfo *printerInfo变更事件发生时的打印机信息。

OH_Print_Init()

Print_ErrorCode OH_Print_Init()

描述

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

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。
PRINT_ERROR_SERVER_FAILURE cups 服务无法启动。

OH_Print_Release()

Print_ErrorCode OH_Print_Release()

描述

此 API 关闭与打印服务的连接，解散先前的回调，并释放打印客户端资源。

系统能力： SystemCapability.Print.PrintFramework

起始版本： 12

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
当前不会返回其他错误码。

OH_Print_StartPrinterDiscovery()

Print_ErrorCode OH_Print_StartPrinterDiscovery(Print_PrinterDiscoveryCallback callback)

描述

此 API 开始发现打印机。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
Print_PrinterDiscoveryCallback callback打印机发现事件的 Print_PrinterDiscoveryCallback。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。
PRINT_ERROR_SERVER_FAILURE 从 BMS 查询打印扩展列表失败。
PRINT_ERROR_INVALID_EXTENSION 未找到可用的打印扩展。

OH_Print_StopPrinterDiscovery()

Print_ErrorCode OH_Print_StopPrinterDiscovery()

描述

此 API 停止发现打印机。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。

OH_Print_ConnectPrinter()

Print_ErrorCode OH_Print_ConnectPrinter(const char *printerId)

描述

此 API 使用打印机 ID 连接打印机。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
const char *printerId待连接的打印机 ID。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。
PRINT_ERROR_INVALID_PRINTER 打印机应在已发现的打印机列表中。
PRINT_ERROR_SERVER_FAILURE 无法找到负责该打印机的扩展。

OH_Print_StartPrintJob()

Print_ErrorCode OH_Print_StartPrintJob(const Print_PrintJob *printJob)

描述

此 API 开始发起打印任务。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
const Print_PrintJob *printJob指向指定打印任务信息的 Print_PrintJob 实例的指针。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。
PRINT_ERROR_INVALID_PRINTER 打印机应在已连接的打印机列表中。
PRINT_ERROR_SERVER_FAILURE 无法在打印服务中创建打印任务。
PRINT_ERROR_INVALID_PRINT_JOB 无法在任务队列中找到该任务。

OH_Print_RegisterPrinterChangeListener()

Print_ErrorCode OH_Print_RegisterPrinterChangeListener(Print_PrinterChangeCallback callback)

描述

此 API 注册打印机变更回调。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
Print_PrinterChangeCallback callback待注册的 Print_PrinterChangeCallback。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务能力。

OH_Print_UnregisterPrinterChangeListener()

void OH_Print_UnregisterPrinterChangeListener()

描述

此 API 注销打印机变更回调。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

OH_Print_QueryPrinterList()

Print_ErrorCode OH_Print_QueryPrinterList(Print_StringList *printerIdList)

描述

此 API 查询已添加的打印机列表。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
Print_StringList *printerIdList用于存储查询到的打印机 ID 列表的 Print_StringList 实例指针。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_INVALID_PARAMETER printerIdList 为 NULL。
PRINT_ERROR_INVALID_PRINTER 无法查询任何已连接的打印机。
PRINT_ERROR_GENERIC_FAILURE 无法复制打印机 ID 列表。

OH_Print_ReleasePrinterList()

void OH_Print_ReleasePrinterList(Print_StringList *printerIdList)

描述

此 API 释放用于查询的打印机列表内存。

系统能力： SystemCapability.Print.PrintFramework

起始版本： 12

参数：

参数项描述
Print_StringList *printerIdList待释放的已查询打印机 ID 列表。

OH_Print_QueryPrinterInfo()

Print_ErrorCode OH_Print_QueryPrinterInfo(const char *printerId, Print_PrinterInfo **printerInfo)

描述

此 API 根据打印机 ID 查询打印机信息。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
const char *printerId待查询的打印机 ID。
Print_PrinterInfo **printerInfo用于存储打印机信息的 Print_PrinterInfo 指针的指针。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。
PRINT_ERROR_INVALID_PARAMETER printerId 为 NULL 或 printerInfo 为 NULL。
PRINT_ERROR_INVALID_PRINTER 无法在已连接的打印机列表中找到该打印机。

OH_Print_ReleasePrinterInfo()

void OH_Print_ReleasePrinterInfo(Print_PrinterInfo *printerInfo)

描述

此 API 释放用于查询的打印机信息内存。

系统能力： SystemCapability.Print.PrintFramework

起始版本： 12

参数：

参数项描述
Print_PrinterInfo *printerInfo待释放的已查询打印机信息指针。

OH_Print_LaunchPrinterManager()

Print_ErrorCode OH_Print_LaunchPrinterManager()

描述

此 API 启动系统的打印机管理窗口。

系统能力： SystemCapability.Print.PrintFramework

起始版本： 12

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_GENERIC_FAILURE 无法启动打印机管理窗口。

OH_Print_QueryPrinterProperties()

Print_ErrorCode OH_Print_QueryPrinterProperties(const char *printerId, const Print_StringList *propertyKeyList, Print_PropertyList *propertyList)

描述

此 API 根据属性关键字列表查询对应的打印机属性值。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
const char *printerId待查询的打印机 ID。
const Print_StringList *propertyKeyList待查询的属性关键字列表。
Print_PropertyList *propertyList查询到的打印机属性值列表。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_INVALID_PARAMETER 参数之一为 NULL 或关键字列表为空。
PRINT_ERROR_INVALID_PRINTER 无法找到指定打印机的属性。
PRINT_ERROR_GENERIC_FAILURE 无法复制打印机属性。

OH_Print_ReleasePrinterProperties()

void OH_Print_ReleasePrinterProperties(Print_PropertyList *propertyList)

描述

此 API 释放用于查询的属性列表内存。

系统能力： SystemCapability.Print.PrintFramework

起始版本： 12

参数：

参数项描述
Print_PropertyList *propertyList待释放的已查询打印机属性值指针。

OH_Print_UpdatePrinterProperties()

Print_ErrorCode OH_Print_UpdatePrinterProperties(const char *printerId, const Print_PropertyList *propertyList)

描述

此 API 根据属性键值对列表设置打印机属性。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
const char *printerId待设置的打印机 ID。
const Print_PropertyList *propertyList待设置的打印机属性值列表。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。

OH_Print_RestorePrinterProperties()

Print_ErrorCode OH_Print_RestorePrinterProperties(const char *printerId, const Print_StringList *propertyKeyList)

描述

此 API 根据属性关键字列表将打印机属性恢复为默认设置。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 12

参数：

参数项描述
const char *printerId待恢复的打印机 ID。
const Print_StringList *propertyKeyList待恢复的属性关键字列表。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。

OH_Print_StartPrintByNative()

Print_ErrorCode OH_Print_StartPrintByNative(const char *printJobName, Print_PrintDocCallback printDocCallback, void *context)

描述

此 API 提供启动打印对话框的能力。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 13

参数：

参数项描述
const char *printJobName此打印任务的名称。
Print_PrintDocCallback printDocCallback打印文档状态回调。
void *context调用方应用的上下文。

返回：

类型说明
Print_ErrorCode返回 PRINT_ERROR_NONE 表示执行成功。
PRINT_ERROR_NO_PERMISSION 需要 ohos.permission.PRINT 权限。
PRINT_ERROR_RPC_FAILURE 无法连接到打印服务。

OH_Print_OnJobStateChanged()

typedef void(*OH_Print_OnJobStateChanged)(const char *jobId, OH_Print_JobState state)

描述

打印任务状态回调。

起始版本： 24

参数：

参数项描述
const char *jobId打印任务的ID。
OH_Print_JobState state当前打印任务的状态。

OH_Print_StartPrintWithJobStateCallback()

Print_ErrorCode OH_Print_StartPrintWithJobStateCallback(const Print_PrintJob *printJob, OH_Print_OnJobStateChanged jobStateChangedCb)

描述

此API下发打印任务，并附带任务状态变更回调功能。

系统能力： SystemCapability.Print.PrintFramework

需要权限： ohos.permission.PRINT

起始版本： 24

参数：

参数项描述
const Print_PrintJob *printJob打印任务结构体。
OH_Print_OnJobStateChanged jobStateChangedCb打印任务状态回调。

返回：

名称值说明
PRINT_ERROR_NONE0执行成功。
PRINT_ERROR_NO_PERMISSION201需要 ohos.permission.PRINT 权限。
PRINT_ERROR_INVALID_PARAMETER401参数之一为NULL或关键字列表为空。
PRINT_ERROR_GENERIC_FAILURE24300001无法复制回调函数。
PRINT_ERROR_RPC_FAILURE24300002无法连接到打印服务。
PRINT_ERROR_SERVER_FAILURE24300003打印服务中无法创建打印任务结构体。
PRINT_ERROR_INVALID_PRINTER24300005无法找到指定打印机的属性。
PRINT_ERROR_INVALID_PRINT_JOB24300006无法在任务队列中找到该任务。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 errorcode-zlib

openharmony 鸿蒙 capi-oh-scan-scan-picturescanprogress

openharmony 鸿蒙 js-apis-screen-lock

openharmony 鸿蒙 capi-os-account-common-h

openharmony 鸿蒙 js-apis-screen-lock-sys

openharmony 鸿蒙 capi-oh-print-print-propertylist

openharmony 鸿蒙 capi-oh-scan

openharmony 鸿蒙 js-apis-system-device

openharmony 鸿蒙 errorcode-intelligentVoice

openharmony 鸿蒙 js-apis-request-sys

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/SmfAVhwc