CleanNtmsDrive 函式 (ntmsapi.h)

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

CleanNtmsDrive 函式會將指定磁碟驅動器的清除要求排入佇列以進行清除。

語法

DWORD CleanNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

[in] hSession

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

[in] lpDriveId

要清除之磁碟驅動器的唯一標識碼。

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

值	意義
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS連結庫遭到拒絕。其他安全性錯誤也是可行的，但它們會指出安全性子系統錯誤。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_DATABASE_FULL	資料庫已滿。
ERROR_INVALID_DRIVE	磁碟驅動器標識碼無效。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_INVALID_LIBRARY	磁碟驅動器的連結庫無效。
ERROR_INVALID_PARAMETER	磁碟驅動器標識碼遺失。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_RESOURCE_DISABLED	磁碟驅動器或連結庫未啟用。
ERROR_SUCCESS	已順利排入佇列。

如果您在 CleanNtmsDrive 函式中選取的磁碟驅動器是獨立磁碟驅動器，磁碟驅動器會標示為已清除，而且 RSM 資料庫中會記下時間。

重新啟動服務時，會刪除佇列清除要求。