已关闭
新增云盘管理占位符转换与更新接口说明文档 #158810
bmi269创建于 8月3日关闭于 5 天前
新增云盘管理占位符转换与更新接口说明文档 #158810
已关闭
共 1 个文件变更+53-0
| @@ -59,6 +59,8 @@ | |||
| 59 | | [CloudDisk_ErrorCode OH_CloudDisk_DeactiveSyncFolder(const CloudDisk_SyncFolderPath syncFolderPath)](#oh_clouddisk_deactivesyncfolder) | 应用取消激活同步根。 | | 59 | | [CloudDisk_ErrorCode OH_CloudDisk_DeactiveSyncFolder(const CloudDisk_SyncFolderPath syncFolderPath)](#oh_clouddisk_deactivesyncfolder) | 应用取消激活同步根。 | |
| 60 | | [CloudDisk_ErrorCode OH_CloudDisk_GetSyncFolders(CloudDisk_SyncFolder **syncFolders, size_t *count)](#oh_clouddisk_getsyncfolders) | 应用获取所有同步根。 | | 60 | | [CloudDisk_ErrorCode OH_CloudDisk_GetSyncFolders(CloudDisk_SyncFolder **syncFolders, size_t *count)](#oh_clouddisk_getsyncfolders) | 应用获取所有同步根。 | |
| 61 | | [CloudDisk_ErrorCode OH_CloudDisk_UpdateCustomAlias(const CloudDisk_SyncFolderPath syncFolderPath, const char *customAlias, size_t customAliasLength)](#oh_clouddisk_updatecustomalias) | 应用更新同步根别名。 | | 61 | | [CloudDisk_ErrorCode OH_CloudDisk_UpdateCustomAlias(const CloudDisk_SyncFolderPath syncFolderPath, const char *customAlias, size_t customAliasLength)](#oh_clouddisk_updatecustomalias) | 应用更新同步根别名。 | |
| 62 | +| [CloudDisk_ErrorCode OH_CloudDisk_ConvertPlaceholderToFile(const CloudDisk_SyncFolderPath syncFolderPath, const CloudDisk_PathInfo relativePathInfo)](#oh_clouddisk_convertplaceholdertofile) | 将占位符文件转换为0字节的普通文件。 | | ||
| 63 | +| [CloudDisk_ErrorCode OH_CloudDisk_UpdatePlaceholder(const CloudDisk_SyncFolderPath syncFolderPath, const CloudDisk_PathInfo relativePathInfo, const OH_CloudDisk_PlaceholderInfo placeholderInfo)](#oh_clouddisk_updateplaceholder) | 更新文件元数据，支持占位符文件和普通文件。 | | ||
| 62 | 64 | ||
| 63 | ## 枚举类型说明 | 65 | ## 枚举类型说明 |
| 64 | 66 | ||
| @@ -423,4 +425,55 @@ CloudDisk_ErrorCode OH_CloudDisk_UpdateCustomAlias(const CloudDisk_SyncFolderPat | |||
| 423 | | -- | -- | | 425 | | -- | -- | |
| 424 | | [CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode) | 如果接口调用成功，返回[CLOUD_DISK_OK](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)；否则返回云盘管理模块的错误码[CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)。 | | 426 | | [CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode) | 如果接口调用成功，返回[CLOUD_DISK_OK](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)；否则返回云盘管理模块的错误码[CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)。 | |
| 425 | 427 | ||
| 428 | +### OH_CloudDisk_ConvertPlaceholderToFile() | ||
| 429 | + | ||
| 430 | +```c | ||
| 431 | +CloudDisk_ErrorCode OH_CloudDisk_ConvertPlaceholderToFile(const CloudDisk_SyncFolderPath syncFolderPath, const CloudDisk_PathInfo relativePathInfo) | ||
| 432 | +``` | ||
| 433 | + | ||
| 434 | +**描述** | ||
| 435 | + | ||
| 436 | +将同步根路径下的占位符文件转换为0字节的普通文件，适用于应用确认不再需要云端回填内容、将占位符还原为本地普通文件的场景。若目标文件不是占位符文件，返回 CLOUD_DISK_NOT_A_PLACEHOLDER。 | ||
| 437 | + | ||
| 438 | +**起始版本：** 26.1.0 | ||
| 439 | + | ||
| 440 | +**参数：** | ||
| 441 | + | ||
| 442 | +| 参数项 | 描述 | | ||
| 443 | +| -- | -- | | ||
| 444 | +| const CloudDisk_SyncFolderPath syncFolderPath | 同步根路径，参考：[CloudDisk_PathInfo](capi-clouddisk-clouddisk-pathinfo.md)。 | | ||
| 445 | +| const CloudDisk_PathInfo relativePathInfo | 同步根路径下的文件相对路径信息，参考：[CloudDisk_PathInfo](capi-clouddisk-clouddisk-pathinfo.md)。 | | ||
| 446 | + | ||
| 447 | +**返回：** | ||
| 448 | + | ||
| 449 | +| 类型 | 说明 | | ||
| 450 | +| -- | -- | | ||
| 451 | +| [CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode) | 如果接口调用成功，返回[CLOUD_DISK_OK](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)；否则返回云盘管理模块的错误码[CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)。 | | ||
| 452 | + | ||
| 453 | +### OH_CloudDisk_UpdatePlaceholder() | ||
| 454 | + | ||
| 455 | +```c | ||
| 456 | +CloudDisk_ErrorCode OH_CloudDisk_UpdatePlaceholder(const CloudDisk_SyncFolderPath syncFolderPath, const CloudDisk_PathInfo relativePathInfo, const OH_CloudDisk_PlaceholderInfo placeholderInfo) | ||
| 457 | +``` | ||
| 458 | + | ||
| 459 | +**描述** | ||
| 460 | + | ||
| 461 | +更新同步根路径下文件的元数据，支持占位符文件和普通文件，适用于云端文件逻辑大小、访问时间或修改时间发生变更后同步本地元数据的场景。 | ||
| 462 | + | ||
| 463 | +**起始版本：** 26.1.0 | ||
| 464 | + | ||
| 465 | +**参数：** | ||
| 466 | + | ||
| 467 | +| 参数项 | 描述 | | ||
| 468 | +| -- | -- | | ||
| 469 | +| const CloudDisk_SyncFolderPath syncFolderPath | 同步根路径，参考：[CloudDisk_PathInfo](capi-clouddisk-clouddisk-pathinfo.md)。 | | ||
| 470 | +| const CloudDisk_PathInfo relativePathInfo | 待更新元数据的文件相对路径信息，参考：[CloudDisk_PathInfo](capi-clouddisk-clouddisk-pathinfo.md)。 | | ||
| 471 | +| const OH_CloudDisk_PlaceholderInfo placeholderInfo | 待更新的占位符元数据，参考：[OH_CloudDisk_PlaceholderInfo](capi-clouddisk-clouddisk-placeholderinfo.md)。 | | ||
| 472 | + | ||
| 473 | +**返回：** | ||
| 474 | + | ||
| 475 | +| 类型 | 说明 | | ||
| 476 | +| -- | -- | | ||
| 477 | +| [CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode) | 如果接口调用成功，返回[CLOUD_DISK_OK](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)；否则返回云盘管理模块的错误码[CloudDisk_ErrorCode](capi-cloud-disk-error-code-h.md#clouddisk_errorcode)。 | | ||
| 478 | + | ||
| 426 | 479 | ||