CancelNtmsLibraryRequest 函数 (ntmsapi.h)

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

CancelNtmsLibraryRequest 函数取消未完成的 RSM 请求，例如对 CleanNtmsDrive 函数的调用。如果库正忙，RSM 会将取消排队并返回成功。

语法

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

[in] hSession

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

[in] lpRequestId

要取消的库请求的唯一标识符。

若要检索现有库请求的列表，请使用 EnumerateNtmsObject 函数。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	只有 RSM 服务器的管理员可以取消库请求。如果请求当前正在处理且无法删除，也会返回此错误。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_OBJECT_NOT_FOUND	找不到库请求对象 ID。如果在发出取消之前完成请求，或者指定了无效的请求 ID，则会发生此错误。
ERROR_SUCCESS	库请求已排队等待取消。