Qt for HarmonyOS/qtohosextras doc/FileShare Namespace

FileShare Namespace

QtOhosExtras::FileShare

The FileShare to expose file permission API. More...

Header:	#include <FileShare>
qmake:	QT += ohosextras
Since:	Qt 5.12.12

This namespace was introduced in Qt 5.12.12.

Classes

class	ActionResult
class	CheckResult
struct	PathPolicy
struct	PathPolicyCheckResult
struct	PathPolicyErrorInfo

Types

enum class	OperationMode { Read, Write }
flags	OperationModes
enum class	PathPolicyError { Unknown, PersistenceForbidden, InvalidMode, InvalidPath, PermissionNotPersisted }

Functions

QSharedPointer<ActionResult>	activatePermission(const QList<PathPolicy> &policies)
QSharedPointer<CheckResult>	checkPersistent(const QList<PathPolicy> &policies)
QSharedPointer<ActionResult>	deactivatePermission(const QList<PathPolicy> &policies)
QSharedPointer<ActionResult>	persistPermission(const QList<PathPolicy> &policies)
QSharedPointer<ActionResult>	revokePermission(const QList<PathPolicy> &policies)

Detailed Description

This API uses file system paths, which differ from the URIs used internally by HarmonyOS. For example, the path /data/storage/el1/bundle/entry/resources/resfile/test.txt will be converted to the URI file://com.your.example/data/storage/el1/bundle/entry/resources/resfile/test.txt , where com.your.example is app bundle name.

To learn more about file paths and URIs in HarmonyOS, see sandbox documentation.

Warning: This API relies on the underlying OHOS implementation. The following functions: persistPermission(), revokePermission(), activatePermission(), deactivatePermission(), and checkPersistent() may be unavailable on some devices. Additionally, there may be limitations on the maximum number of policies, and certain permissions may need to be explicitly granted to the application.

For more details and limitations, refer to the API documentation.

Classes

class ActionResult

The ActionResult class encapsulates the result of all file requested access permission actions. More...

class CheckResult

The CheckResult class encapsulates the result of all requested file access permission checks. More...

class PathPolicy

The PathPolicy struct encapsulates information required to request file access permissions for a specified path. More...

class PathPolicyCheckResult

The PathPolicyCheckResult struct contains the result of a file permission check request for a specified path, indicating whether access is granted or denied. More...

class PathPolicyErrorInfo

The PathPolicyErrorInfo struct contains the result of a file access permission request for a specified path. More...

Type Documentation

enum class FileShare::OperationMode
flags FileShare::OperationModes

Defines permissions on path. See FileShare_OperationMode. The flags can be combined using bitwise operations.

Constant	Value	Description
QtOhosExtras::FileShare::OperationMode::Read	1 << 0	Read on path
QtOhosExtras::FileShare::OperationMode::Write	1 << 1	Write on path

This enum was introduced or modified in Qt 5.12.12.

The OperationModes type is a typedef for QFlags<OperationMode>. It stores an OR combination of OperationMode values.

See also PathPolicy.

enum class FileShare::PathPolicyError

Defines permission policy error codes. See FileShare_PolicyErrorCode.

Constant	Value	Description
QtOhosExtras::FileShare::PathPolicyError::Unknown	0	Error type is unknown or not recognized
QtOhosExtras::FileShare::PathPolicyError::PersistenceForbidden	1	The permission on the path cannot be persisted
QtOhosExtras::FileShare::PathPolicyError::InvalidMode	2	Invalid operation mode
QtOhosExtras::FileShare::PathPolicyError::InvalidPath	3	Invalid path
QtOhosExtras::FileShare::PathPolicyError::PermissionNotPersisted	4	The permission is not persisted

This enum was introduced or modified in Qt 5.12.12.

See also PathPolicyErrorInfo.

Function Documentation

QSharedPointer<ActionResult> FileShare::activatePermission(const QList<PathPolicy> &policies)

Activates file or folder permissions from policies. The success of the action can be determined from ActionResult.

This function calls OH_FileShare_ActivatePermission. Each time an application is started, its persistent permissions have not been loaded to the memory. Use this function to make a persistent permission active after the application is started. If the activation fails because the permission has not been persisted, use persistPermission() first.

To deactivate an active permission, use deactivatePermission().

See also ActionResult, PathPolicy, persistPermission(), and deactivatePermission().

QSharedPointer<CheckResult> FileShare::checkPersistent(const QList<PathPolicy> &policies)

Checks if file or folder permissions from policies have persistent permissions. The result check for each file or folder can be determined from CheckResult. CheckResult::PathPolicyCheckResult::result will be set to true for each file or folder only for succesufull check and persistent permission found, false otherwise.

This function calls OH_FileShare_CheckPersistentPermission.

To persist permission, use persistPermission().

See also CheckResult, PathPolicy, and persistPermission().

QSharedPointer<ActionResult> FileShare::deactivatePermission(const QList<PathPolicy> &policies)

Deactivates file or folder permissions from policies. The success of the action can be determined from ActionResult.

This function calls OH_FileShare_DeactivatePermission.

To activate permission, use activatePermission().

See also ActionResult, PathPolicy, and activatePermission().

QSharedPointer<ActionResult> FileShare::persistPermission(const QList<PathPolicy> &policies)

Persists file or folder permissions from policies. The success of the action can be determined from ActionResult.

This function calls OH_FileShare_PersistPermission. persistPermission() stores persistence data in the system database. After persistPermission() call, permissions are not yet active. Use activatePermission() to activate permissions. persistPermission() must be called at least once before activatePermission().

To revoke a persistent permission, use revokePermission().

See also ActionResult, PathPolicy, revokePermission(), and activatePermission().

QSharedPointer<ActionResult> FileShare::revokePermission(const QList<PathPolicy> &policies)

Revokes file or folder permissions from policies. The success of the action can be determined from ActionResult.

This function calls OH_FileShare_RevokePermission.

To persist permission, use persistPermission().

See also ActionResult, PathPolicy, and persistPermission().