Volume Management
NOTE
- The initial APIs of this module are supported since API version 9.
- API version 9 is a canary release for trial use. The APIs of this version may be unstable.
Modules to Import
import volumemanager from "@ohos.volumeManager";
volumemanager.getAllVolumes
getAllVolumes(): Promise<Array<Volume>>
Asynchronously obtains information about all available volumes. This method uses a promise to return the result.
System capability: SystemCapability.FileManagement.StorageService.Volume
- Return value
Type | Description |
---|---|
Promise<Volume[]> | Promise used to return the execution result. |
-
Example
volumemanager.getAllVolumes().then(function(volumes){ // do something });
volumemanager.getAllVolumes
getAllVolumes(callback: AsyncCallback<Array<Volume>>): void
Asynchronously obtains information about all available volumes. This method uses a callback to return the result.
System capability: SystemCapability.FileManagement.StorageService.Volume
- Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
callback | callback:AsyncCallback<Volume[]> | Yes | Callback invoked to return the volume information obtained. |
-
Example
let uuid = ""; volumemanager.getAllVolumes(uuid, function(error, volumes){ // do something });
volumemanager.mount
mount(volumeId: string): Promise<boolean>
Asynchronously mounts a volume. This method uses a promise to return the result.
System capability: SystemCapability.FileManagement.StorageService.Volume
- Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
volumeId | string | Yes | Volume ID. |
- Return value
Type | Description |
---|---|
Promise<boolean> | Promise used to return the execution result. |
-
Example
let volumeId = ""; volumemanager.mount(volumeId).then(function(flag){ // do something });
volumemanager.mount
mount(volumeId: string, callback:AsyncCallback<boolean>):void
Asynchronously obtains the available space of the specified volume. This method uses a callback to return the result.
System capability: SystemCapability.FileManagement.StorageService.Volume
- Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
volumeId | string | Yes | Volume ID. |
callback | callback:AsyncCallback<boolean> | Yes | Callback invoked to return the execution result. |
-
Example
let volumeId = ""; volumemanager.mount(volumeId, function(error, flag){ // do something });
volumemanager.unmount
unmount(volumeId: string): Promise<boolean>
Asynchronously unmounts a volume. This method uses a promise to return the result.
System capability: SystemCapability.FileManagement.StorageService.Volume
- Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
volumeId | string | Yes | Volume ID. |
- Return value
Type | Description |
---|---|
Promise<boolean> | Promise used to return the execution result. |
-
Example
let volumeId = ""; volumemanager.unmount(volumeId).then(function(flag){ // do something });
volumemanager.unmount
unmount(volumeId: string, callback:AsyncCallback<boolean>):void
Asynchronously unmounts a volume. This method uses a callback to return the result.
System capability: SystemCapability.FileManagement.StorageService.Volume
- Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
volumeId | string | Yes | Volume ID. |
callback | callback:AsyncCallback<boolean> | Yes | Callback invoked to return the execution result. |
-
Example
let volumeId = ""; volumemanager.unmount(volumeId, function(error, flag){ // do something });
Volume
System capability: SystemCapability.FileManagement.StorageService.Volume
Attributes
Name | Type | Description |
---|---|---|
id | number | Volume ID. |
uuid | string | Universally unique identifier (UUID) of the volume. |
description | string | Description of the volume. |
removable | boolean | Whether the volume is a removable storage device. |
state | int | Current volume status. |
path | string | Mount address of the volume. |