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	驱动器 ID 无效。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_INVALID_LIBRARY	驱动器的库无效。
ERROR_INVALID_PARAMETER	缺少驱动器 ID。
ERROR_INVALID_STATE	驱动器不包含媒体。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_SUCCESS	函数成功。

如果 DismountNtmsDrive 函数指定的驱动器为空或媒体已打开，则返回错误。否则，媒体将返回到其槽。

卸载独立驱动器的请求会将驱动器置于可卸载状态并返回成功。