1 Star 0 Fork 5K

平凡 / docs

forked from OpenHarmony / docs 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
PMS.md 15.17 KB
一键复制 编辑 原始数据 按行查看 历史
wenjun 提交于 2020-09-08 10:08 . add OpenHarmony 1.0 baseline

PMS

Overview

Manages permissions.

This module provides interfaces for managing permissions of third-party applications.

Since:

1.0

Version:

1.0

Summary

Files

File Name

Description

pms_interface.h

Declares interfaces for managing permissions.

Functions

Function Name

Description

CheckPermission (int taskID, const char *permissionName)

int 

Checks whether the caller (generally a third-party application) has a specified permission of a system service API.

QueryPermission (const char *identifier, PermissionSaved **permissions, int *permNum)

int 

Queries all permissions requested by the application and checks whether these permissions are granted.

GrantPermission (const char *identifier, const char *permName)

int 

Grants a specified permission to the application.

RevokePermission (const char *identifier, const char *permName)

int 

Revokes a specified permission from the application.

GrantRuntimePermission (int taskID, const char *permissionName)

int 

Grants a specified runtime permission to an application.

RequestPermission (int taskID, const char *permissionName)

int 

Requests a specified permission.

Details

Function Documentation

CheckPermission()

int CheckPermission (int taskID, const char * permissionName )

Description:

Checks whether the caller (generally a third-party application) has a specified permission of a system service API.

Parameters:

Name

Description

taskId Indicates the process ID of the caller. The range is [0, INT_MAX].
permissionName Indicates the pointer to the permission name. For details, see the developer documentation.

Returns:

Returns 1 if the caller has the permission; returns 0 otherwise.

GrantPermission()

int GrantPermission (const char * identifier, const char * permName )

Description:

Grants a specified permission to the application.

Parameters:

Name

Description

identifier Indicates the pointer to the application bundle name.
permName Indicates the pointer to the permission name. For details, see the developer documentation.

Returns:

Returns 0 if the permission is successfully granted; returns an error code defined in PmsErrorCode otherwise.

GrantRuntimePermission()

int GrantRuntimePermission (int taskID, const char * permissionName )

Description:

Grants a specified runtime permission to an application.

This function applies to sensitive permissions that can be granted to the application only when the application is running.

Parameters:

Name

Description

taskId Indicates the process ID of the application. The range is [0, INT_MAX].
permissionName Indicates the pointer to the permission name. For details, see the developer documentation.

Returns:

Returns 0 if the permission is successfully granted; returns an error code defined in PmsErrorCode otherwise.

QueryPermission()

int QueryPermission (const char * identifier, [PermissionSaved](PermissionSaved.md) ** permissions, int * permNum )

Description:

Queries all permissions requested by the application and checks whether these permissions are granted.

Parameters:

Name

Description

identifier Indicates the pointer to the application bundle name.
permissions Indicates the double pointer to the array of permissions. You need to pass the PermissionSaved pointer and release it after finishing using it.
permNum Indicates the pointer to the number of permissions in the array, which is an integer.

Returns:

Returns 0 if the operation is successful; returns an error code defined in PmsErrorCode otherwise.

RequestPermission()

int RequestPermission (int taskID, const char * permissionName )

Description:

Requests a specified permission.

Parameters:

Name

Description

taskId Indicates the process ID of the application. The range is [0, INT_MAX].
permissionName Indicates the pointer to the permission name. For details, see the developer documentation.

Returns:

Returns 0 if the operation is successful; returns an error code defined in PmsErrorCode otherwise.

RevokePermission()

int RevokePermission (const char * identifier, const char * permName )

Description:

Revokes a specified permission from the application.

Parameters:

Name

Description

identifier Indicates the pointer to the application bundle name.
permName Indicates the pointer to the permission name. For details, see the developer documentation.

Returns:

Returns 0 if the permission is successfully revoked; returns an error code defined in PmsErrorCode otherwise.

1
https://gitee.com/pingfan_vs_hs/docs.git
git@gitee.com:pingfan_vs_hs/docs.git
pingfan_vs_hs
docs
docs
master

搜索帮助