Update an Asset (C/C++)
Available APIs
For details about the API, see:
Attributes in query:
Attribute Name (Asset_Tag) | Attribute Content (Asset_Value) | Mandatory | Description |
---|---|---|---|
ASSET_TAG_ALIAS | Type: uint8[] Length: 1-256 bytes |
Yes | Asset alias, which uniquely identifies an asset. |
ASSET_TAG_ACCESSIBILITY | Type: uint32_t Value range: see Asset_Accessibility |
No | Access control based on the lock screen status. |
ASSET_TAG_REQUIRE_PASSWORD_SET | Type: bool | No | Whether the asset is accessible only when a lock screen password is set. |
ASSET_TAG_AUTH_TYPE | Type: uint32_t Value range: see Asset_AuthType |
No | Type of user authentication required for accessing the asset. |
ASSET_TAG_SYNC_TYPE | Type: uint32_t Value range: see Asset_SyncType |
No | Type of sync supported by the asset. |
ASSET_TAG_IS_PERSISTENT | Type: bool | No | Whether to retain the asset when the application is uninstalled. |
ASSET_TAG_DATA_LABEL_CRITICAL_1 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service with integrity protection. |
ASSET_TAG_DATA_LABEL_CRITICAL_2 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service with integrity protection. |
ASSET_TAG_DATA_LABEL_CRITICAL_3 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service with integrity protection. |
ASSET_TAG_DATA_LABEL_CRITICAL_4 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service with integrity protection. |
ASSET_TAG_DATA_LABEL_NORMAL_1 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service without integrity protection. |
ASSET_TAG_DATA_LABEL_NORMAL_2 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service without integrity protection. |
ASSET_TAG_DATA_LABEL_NORMAL_3 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service without integrity protection. |
ASSET_TAG_DATA_LABEL_NORMAL_4 | Type: uint8[] Length: 1-512 bytes |
No | Additional asset data customized by the service without integrity protection. |
Attributes in attributesToUpdate:
Attribute Name (Asset_Tag) | Attribute Content (Asset_Value) | Mandatory | Description |
---|---|---|---|
SECRET | Type: uint8[] Length: 1-1024 bytes |
No | New asset plaintext. |
DATA_LABEL_NORMAL_1 | Type: uint8[] Length: 1-512 bytes |
No | Additional data of the new asset customized by the service without integrity protection. |
DATA_LABEL_NORMAL_2 | Type: uint8[] Length: 1-512 bytes |
No | Additional data of the new asset customized by the service without integrity protection. |
DATA_LABEL_NORMAL_3 | Type: uint8[] Length: 1-512 bytes |
No | Additional data of the new asset customized by the service without integrity protection. |
DATA_LABEL_NORMAL_4 | Type: uint8[] Length: 1-512 bytes |
No | Additional data of the new asset customized by the service without integrity protection. |
Example
Update asset demo_alias as follows: change the asset plaintext to demo_pwd_new and additional attribute to demo_label_new.
-
Add the dynamic library in the CMake script.
target_link_libraries(entry PUBLIC libasset_ndk.z.so)
-
Add an asset.
#include <string.h> #include "asset/asset_api.h" void UpdateAsset() { static const char *ALIAS = "demo_alias"; static const char *SECRET = "demo_pwd_new"; static const char *LABEL = "demo_label_new"; Asset_Blob alias = { (uint32_t)(strlen(ALIAS)), (uint8_t *)ALIAS }; Asset_Blob new_secret = { (uint32_t)(strlen(SECRET)), (uint8_t *)SECRET }; Asset_Blob new_label = { (uint32_t)(strlen(LABEL)), (uint8_t *)LABEL }; Asset_Attr query[] = { { .tag = ASSET_TAG_ALIAS, .value.blob = alias } }; Asset_Attr attributesToUpdate[] = { { .tag = ASSET_TAG_SECRET, .value.blob = new_secret }, { .tag = ASSET_TAG_DATA_LABEL_NORMAL_1, .value.blob = new_label }, }; int32_t ret = OH_Asset_Update(query, sizeof(query) / sizeof(query[0]), attributesToUpdate, sizeof(attributesToUpdate) / sizeof(attributesToUpdate[0])); if (ret == ASSET_SUCCESS) { // Asset updated successfully. } else { // Failed to update Asset. } }
Constraints
N/A.