DismountNtmsDrive 函式 (ntmsapi.h)

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

DismountNtmsDrive 函式會將命令排入佇列，將指定磁碟驅動器中的媒體移至其儲存位置。此函式應該與 MountNtmsMedia 函式配對。

語法

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

[in] hSession

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

[in] lpDriveId

磁碟驅動器物件的唯一標識碼。

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

值	意義
ERROR_ACCESS_DENIED	連結庫NTMS_MODIFY_ACCESS遭到拒絕。也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。 Windowsxp：連結庫NTMS_CONTROL_ACCESS遭到拒絕。也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_DATABASE_FULL	資料庫已滿。
ERROR_DEVICE_NOT_AVAILABLE	磁碟驅動器或連結庫未啟用。
ERROR_INVALID_DRIVE	磁碟驅動器標識碼無效。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_INVALID_LIBRARY	磁碟驅動器的連結庫無效。
ERROR_INVALID_PARAMETER	磁碟驅動器標識碼遺失。
ERROR_INVALID_STATE	磁碟驅動器不包含媒體。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_SUCCESS	函式成功。

如果 DismountNtmsDrive 函式指定的磁碟驅動器是空的，或者如果開啟媒體，則會傳回錯誤。否則，媒體會傳回至其位置。

卸除獨立磁碟驅動器的要求會讓磁碟驅動器處於可卸除狀態，並傳回成功。