SetNtmsMediaComplete 函数 (ntmsapi.h)

[从 Windows 7 和 Windows Server 2008 R2 起，可移动存储管理器不再可用。]

SetNtmsMediaComplete 函数将一段逻辑媒体标记为已完成。

语法

DWORD SetNtmsMediaComplete(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

[in] hSession

OpenNtmsSession 函数返回的会话的句柄。

[in] lpMediaId

一段逻辑介质的唯一标识符。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝NTMS_CONTROL_ACCESS媒体的媒体池。其他安全错误也可能存在，但它们表示存在安全子系统错误。 Windowsxp：拒绝NTMS_MODIFY_ACCESS媒体的媒体池。其他安全错误也可能存在，但它们表示存在安全子系统错误。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_DATABASE_FULL	数据库已满。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_INVALID_MEDIA	媒体标识符无效。
ERROR_INVALID_MEDIA_POOL	媒体的媒体池无效。
ERROR_INVALID_PARAMETER	缺少媒体标识符。
ERROR_INVALID_STATE	媒体未处于已分配状态或当前已装载。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_SUCCESS	函数成功。

SetNtmsMediaComplete 函数将指定的媒体标记为 Complete。当应用程序不再要写入媒体时，应用程序会将媒体标记为“完成”。不能使用 NTMS_MOUNT_WRITE 标志装载完整的媒体。

当应用程序到达媒体的末尾时，通常会使用 SetNtmsMediaComplete 函数。无法将装载或正在使用的媒体标记为已完成。