decommissionNtmsMedia 函式 (ntmsapi.h)

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

DecommissionNtmsMedia 函式會將側邊從 [可用] 狀態移至 [已解除委任] 狀態。

語法

DWORD DecommissionNtmsMedia(
  [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	函式成功。

由 DecommissionNtmsMedia 函式解除委任的媒體是由 RSM 辨識，但已解除委任的媒體不包含任何數據，而且永遠不會再使用。

只有處於可用狀態的媒體可以解除委任。如需詳細資訊，請參閱媒體生命週期。