# cm_native_type.h

> phone 22+ | 2in1 22+ | tablet 22+ | tv 22+ | wearable 22+

## 概述

> phone | 2in1 | tablet | tv | wearable

提供CertManager中的枚举变量、结构体定义、宏定义和错误码。

**引用文件：** <device_certificate/certmanager/cm_native_type.h>

**库：** libohcert_manager.z.so

**系统能力：** SystemCapability.Security.CertificateManager

**起始版本：** 22

**相关模块：** [CertManagerType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-certmanagertype)

## 汇总

> phone | 2in1 | tablet | tv | wearable

### 结构体

> phone | 2in1 | tablet | tv | wearable

|名称|typedef关键字|描述|
|:----------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------|:-----------------|
|[OH_CM_Blob](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-certmanagertype-oh-cm-blob)|OH_CM_Blob|定义存放数据的结构体类型。|
|[OH_CM_Credential](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-certmanagertype-oh-cm-credential)|OH_CM_Credential|定义证书凭据详情的结构体类型。|
|[OH_CM_CredentialDetailList](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-certmanagertype-oh-cm-credentialdetaillist)|OH_CM_CredentialDetailList|定义证书凭据详情列表的结构体类型。|
|[OH_CM_UkeyInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-certmanagertype-oh-cm-ukeyinfo)|OH_CM_UkeyInfo|定义USB证书凭据信息的结构体类型。|

### 枚举

> phone | 2in1 | tablet | tv | wearable

|名称|typedef关键字|描述|
|:----------------------------------------------------|:-----------------------|:--------|
|[OH_CM_ErrorCode](#oh_cm_errorcode)|OH_CM_ErrorCode|错误码。|
|[OH_CM_CertificatePurpose](#oh_cm_certificatepurpose)|OH_CM_CertificatePurpose|证书凭据用途类型。|

### 宏定义

> phone | 2in1 | tablet | tv | wearable

|名称|描述|
|:------------------------------------|:------------------------------|
|OH_CM_MAX_LEN_CERTIFICATE_CHAIN 24588|证书链最大长度，单位：Byte。 **起始版本：** 22|
|OH_CM_MAX_LEN_URI 256|URI最大长度，单位：Byte。 **起始版本：** 22|
|OH_CM_MAX_LEN_CERT_ALIAS 129|证书别名的最大长度，单位：Byte。 **起始版本：** 22|
|OH_CM_MAX_LEN_TYPE_NAME 1025|证书类型最大长度，单位：Byte。 **起始版本：** 22|

## 枚举类型说明

> phone | 2in1 | tablet | tv | wearable

### OH_CM_ErrorCode

> phone 22+ | 2in1 22+ | tablet 22+ | tv 22+ | wearable 22+

```c
enum OH_CM_ErrorCode
```

**描述**

错误码。

**起始版本：** 22

|枚举项|描述|
|:-------------------------------------------|:-------------------------------------|
|OH_CM_SUCCESS = 0|成功。|
|OH_CM_HAS_NO_PERMISSION = 201|权限校验失败。|
|OH_CM_CAPABILITY_NOT_SUPPORTED = 801|设备不支持。|
|OH_CM_INNER_FAILURE = 17500001|内部错误。可能原因：1.IPC通信失败；2.内存操作错误；3.文件操作错误。|
|OH_CM_NOT_FOUND = 17500002|证书不存在。|
|OH_CM_INVALID_CERT_FORMAT = 17500003|密钥库格式无效或密钥库密码不正确。|
|OH_CM_MAX_CERT_COUNT_REACHED = 17500004|证书或凭据数量达到上限。|
|OH_CM_NO_AUTHORIZATION = 17500005|应用未经用户授权。|
|OH_CM_DEVICE_ENTER_ADVSECMODE = 17500007|设备进入坚盾守护模式。该模式下CA证书安装操作受限。|
|OH_CM_STORE_PATH_NOT_SUPPORTED = 17500009|不支持指定的证书存储路径。|
|OH_CM_ACCESS_UKEY_SERVICE_FAILED = 17500010|USB证书凭据访问失败。|
|OH_CM_PARAMETER_VALIDATION_FAILED = 17500011|参数校验失败，例如参数格式或参数范围无效。|

### OH_CM_CertificatePurpose

> phone 22+ | 2in1 22+ | tablet 22+ | tv 22+ | wearable 22+

```c
enum OH_CM_CertificatePurpose
```

**描述**

证书凭据用途类型。

**起始版本：** 22

|枚举项|描述|
|:-----------------------------|:-------------|
|OH_CM_CERT_PURPOSE_DEFAULT = 0|默认用途，用于凭据签名。|
|OH_CM_CERT_PURPOSE_ALL = 1|所有用途，用于查询凭据功能。|
|OH_CM_CERT_PURPOSE_SIGN = 2|签名用途。|
|OH_CM_CERT_PURPOSE_ENCRYPT = 3|加密用途。|