harmony 鸿蒙Environment

Environment

Provides the capability of obtaining the root directory of user files.

Since: 12

Name	Description
oh_environment.h	Defines the native APIs used to obtain the sandbox paths of the user files.

Name	Description
FileManagement_ErrCode OH_Environment_GetUserDownloadDir (char **result)	Obtains the sandbox path of the Download root directory. Only 2-in-1 devices are supported.
FileManagement_ErrCode OH_Environment_GetUserDesktopDir (char **result)	Obtains the sandbox path of the Desktop root directory. Only 2-in-1 devices are supported.
FileManagement_ErrCode OH_Environment_GetUserDocumentDir (char **result)	Obtains the sandbox path of the Document root directory. Only 2-in-1 devices are supported.

FileManagement_ErrCode OH_Environment_GetUserDesktopDir (char ** result)

Description Obtains the sandbox path of the Desktop root directory.

Since: 12

Parameters

Name	Description
result	Double pointer to the sandbox path of the Desktop root directory obtained. You also need to include malloc.h and use free() to release the memory allocated.

Required permissions

ohos.permission.READ_WRITE_DESKTOP_DIRECTORY

Return value

FileManagement_ErrCode

FileManagement_ErrCode OH_Environment_GetUserDocumentDir (char ** result)

Description Obtains the sandbox path of the Document root directory.

Since: 12

Parameters

Name	Description
result	Double pointer to the sandbox path of the Document root directory obtained. You also need to include malloc.h and use free() to release the memory allocated.

Required permissions

ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY

Return value

FileManagement_ErrCode

FileManagement_ErrCode OH_Environment_GetUserDownloadDir (char ** result)

Description Obtains the sandbox path of the Download root directory.

Since: 12

Parameters

Name	Description
result	Double pointer to the path of the Download root directory obtained. You also need to include malloc.h and use free() to release the memory allocated.