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	至少有一個媒體標識碼無效。
ERROR_INVALID_MEDIA_POOL	邏輯媒體的一或多個媒體集區無效。
ERROR_INVALID_PARAMETER	至少遺漏一個媒體標識碼。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_SUCCESS	函式成功。

SwapNtmsMedia 函式可用來更新實體媒體，而不會影響應用程式。

這兩個 LMID 的媒體不得使用，此函式才能成功。