dismountNtmsMedia 函数 (ntmsapi.h)

[从 Windows 7 和 Windows Server 2008 R2 起，可移动存储管理器不再可用。]

DismountNtmsMedia 函数将命令排队，以将驱动器中的指定媒体移动到其存储。此函数应与 MountNtmsMedia 函数配对。

语法

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

[in] hSession

OpenNtmsSession 函数返回的会话的句柄。

[in] lpMediaId

至少一个逻辑介质或一侧的数组。

[in] dwCount

lpMediaId 参数中的媒体标识符数。

[in] dwOptions

选项。此参数可以是以下值。

值	含义
NTMS_DISMOUNT_DEFERRED	将媒体状态标记为“可卸载”，并将介质保留在驱动器中。使用已卸除或可卸载的驱动器满足后续装载请求。默认为立即卸载。
NTMS_DISMOUNT_IMMEDIATE	立即卸载驱动器。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝NTMS_USE_ACCESS包含媒体的媒体池或库。其他安全错误也可能存在，但它们表示存在安全子系统错误。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_DATABASE_FULL	数据库已满。
ERROR_DEVICE_NOT_AVAILABLE	执行卸载所需的一个或多个资源当前不可用， (可能已禁用) 。
ERROR_INVALID_LIBRARY	包含媒体的库无效。
ERROR_INVALID_MEDIA	指定的介质中至少有一个无效。
ERROR_INVALID_STATE	卸载期间出现意外的媒体或设备状态。
ERROR_MEDIA_OFFLINE	指定的媒体处于脱机状态。
ERROR_MEDIA_NOT_AVAILABLE	执行装载所需的一个或多个媒体资源当前不可用， (可能已禁用) 。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生内存分配失败。
ERROR_SUCCESS	媒体卸除已排队。
ERROR_TIMEOUT	应用程序尝试获取一个或多个资源时超时事件已过期。

应用程序在使用指定的介质后，必须使用 DismountNtmsMedia 函数释放驱动器资源。未发布的媒体不能由其他 RSM 会话使用。

DismountNtmsMedia 函数在操作使用 RSM 排队后立即返回。应用程序可以等待侧状态变为空闲状态。