通过

弹出NtmsCleaner 函数 (ntmsapi.h)

  • 项目

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

EjectNtmsCleaner 函数从当前保留的清洁槽中弹出清洁盒。

语法

DWORD EjectNtmsCleaner(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpLibrary,
  [in, out] LPNTMS_GUID lpEjectOperation,
  [in]      DWORD       dwAction
);

参数

[in] hSession

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

[in] lpLibrary

库对象的唯一标识符。

[in, out] lpEjectOperation

弹出进程库操作的 GUID。 如果 dwAction NTMS_EJECT_START，则此参数接收操作的 GUID。 如果 dwAction NTMS_EJECT_STOP，则必须将此参数设置为 GUID 才能停止操作。

[in] dwAction

要执行的操作。 此参数可以是以下值之一。

值 含义
NTMS_EJECT_START
 使用端口启动弹出操作。 将弹出指定的介质，直到发生超时事件或使用NTMS_EJECT_STOP再次调用函数。 超时值在库对象中指定，并应用于库中的所有弹出。
NTMS_EJECT_STOP
 仅适用于具有 NTMS_IEPORT 对象的库。 在超时事件失效之前终止 由 lpEjectOperation 指定的弹出进程。

返回值

此函数返回以下值之一。

值 含义
ERROR_ACCESS_DENIED
 拒绝访问一个或多个 RSM 对象。
ERROR_INVALID_HANDLE
 hSession 参数中提供的值无效。
ERROR_INVALID_LIBRARY
 无法从数据库检索库定义。
ERROR_NO_SLOT_SET
 此库没有保留的更清洁槽。
ERROR_NOT_CONNECTED
 无法连接到 RSM 服务。
ERROR_SLOT_EMPTY
 清理器槽已保留，但已为空。
ERROR_SLOT_NOT_PRESENT
 保留一个清理器槽，但该槽当前未安装在库中。 当库中至少缺少一个杂志时，会发生此错误。
ERROR_SUCCESS
 函数成功。

注解

弹出请求排队后， EjectNtmsCleaner 函数会立即返回到应用程序。

如果在 弹出NtmsCleaner 函数中指定的库具有NTMS_IEPORT对象，则 RSM 使用 NTMS_IEPORT 对象来弹出清理器。 如果没有NTMS_IEPORT对象，则使用 NTMS_IEDOOR 对象允许操作员访问清理器槽。

在脱机库中不会跟踪弹出的清洁器盒。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntmsapi.h
Library Ntmsapi.lib
DLL Ntmsapi.dll

另请参阅

CleanNtmsDrive

清理器管理功能

InjectNtmsCleaner

ReleaseNtmsCleanerSlot

ReserveNtmsCleanerSlot