SwapNtmsMedia 函数 (ntmsapi.h)

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

SwapNtmsMedia 函数交换与两个指定 LMID 关联的侧。指定的 LMID 必须位于同一媒体池中。

语法

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

[in] hSession

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

[in] lpMediaId1

逻辑介质块的唯一标识符 (LMID) 。

[in] lpMediaId2

逻辑介质块的唯一标识符 (LMID) 。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝向任一媒体的媒体池NTMS_MODIFY_ACCESS。其他安全错误也可能存在，但它们表示存在安全子系统错误。
ERROR_BAD_FORMAT	没有媒体标签库可识别介质标签。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_DATABASE_FULL	数据库已满。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_INVALID_MEDIA	至少有一个媒体 ID 无效。
ERROR_INVALID_MEDIA_POOL	逻辑媒体的一个或多个媒体池无效。
ERROR_INVALID_PARAMETER	至少缺少一个媒体标识符。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_SUCCESS	函数成功。

SwapNtmsMedia 函数用于在不影响应用程序的情况下更新物理媒体。

要使此函数成功，两个 LMID 的媒体不得处于使用状态。