DeallocateNtmsMedia 函式 (ntmsapi.h)

[從 Windows 7 和 Windows Server 2008 R2 起，不再提供卸除式儲存管理員。]

DeallocateNtmsMedia 函式會解除分配與指定之邏輯媒體相關聯的端。

語法

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

[in] hSession

OpenNtmsSession 函式所傳回之會話的句柄。

[in] lpMediaId

邏輯媒體的唯一標識碼 (LMID) 。

dwOptions

保留;必須是零。

此函式會傳回下列其中一個值。

值	意義
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS到媒體的媒體集區遭到拒絕。也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。 Windowsxp： NTMS_MODIFY_ACCESS媒體的媒體集區遭到拒絕。也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_DATABASE_FULL	資料庫已滿。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_INVALID_MEDIA	LMID 無效。
ERROR_INVALID_PARAMETER	缺少媒體或媒體集區標識碼。
ERROR_INVALID_PARTITION	LMID 端無效。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_SUCCESS	函式成功。

當邏輯媒體與 DeallocateNtmsMedia 函式解除分配時，RSM 會將與邏輯媒體相關聯的側邊置於 [可用] 或 [已解除委任的媒體] 狀態。當邏輯媒體解除分配時，邏輯媒體會從系統中刪除。

如果側邊已配置媒體集區中指定的最大次數，則會在解除分配時解除委任。媒體處於解除委任狀態之後，就無法再次配置。

Windows Server 2003： 如果媒體傳回至免費集區，NTMS_USE_ACCESS至免費集區，而且需要NTMS_CONTROL_ACCESS來源集區。如果免費集區不是目的地媒體集區，來源和目的地集區上都需要NTMS_CONTROL_ACCESS。