1# 查询用户注册凭据的状态
2
3
4调用者需感知用户注册凭据（人脸、指纹、口令）的变化，可以通过该接口查询当前用户注册凭据的状态。
5
6
7## 接口说明
8
9具体参数、返回值、错误码等描述，请参考对应的[API文档](../../reference/apis-user-authentication-kit/js-apis-useriam-userauth.md#userauthgetenrolledstate12)。
10
11| 接口名称 | 功能描述 |
12| -------- | -------- |
13| getEnrolledState(authType : UserAuthType): EnrolledState | 根据指定的认证类型，查询用户注册凭据的状态，用于感知注册凭据变化。 |
14
15
16## 开发步骤
17
181. [申请权限](prerequisites.md#申请权限)：ohos.permission.ACCESS_BIOMETRIC。
19
202. 指定认证类型（[UserAuthType](../../reference/apis-user-authentication-kit/js-apis-useriam-userauth.md#userauthtype8)），调用[getEnrolledState](../../reference/apis-user-authentication-kit/js-apis-useriam-userauth.md#userauthgetenrolledstate12)接口查询用户注册凭据的状态。
21
22以查询用户人脸注册凭据的状态为例：
23
24```ts
25import { BusinessError } from  '@kit.BasicServicesKit';
26import { userAuth } from '@kit.UserAuthenticationKit';
27
28try {
29  let enrolledState = userAuth.getEnrolledState(userAuth.UserAuthType.FACE);
30  console.info(`get current enrolled state success, enrolledState: ${JSON.stringify(enrolledState)}`);
31} catch (error) {
32  const err: BusinessError = error as BusinessError;
33  console.error(`get current enrolled state failed, Code is ${err?.code}, message is ${err?.message}`);
34}
35```
36