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	驱动器 ID 无效。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_INVALID_LIBRARY	驱动器的库无效。
ERROR_INVALID_PARAMETER	缺少驱动器 ID。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_RESOURCE_DISABLED	未启用驱动器或库。
ERROR_SUCCESS	清理已成功排队。

如果在 CleanNtmsDrive 函数中选择的驱动器是独立驱动器，则会将驱动器标记为已清理，并在 RSM 数据库中记录时间。

重新启动服务时，将删除排队的清理请求。