DeleteNtmsRequests 函数 (ntmsapi.h)

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

DeleteNtmsRequests 函数从 RSM 数据库中删除请求或请求列表。将删除处于已完成、失败、拒绝或取消状态的库或操作员请求。无法删除已提交的请求、排队的请求、等待的请求和正在进行的请求。

语法

DWORD DeleteNtmsRequests(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

[in] hSession

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

[in] lpRequestId

要删除的库和运算符请求的标识符列表。

[in] dwType

请求类型。此参数的取值可为下列值之一：

值	含义
NTMS_LIBREQUEST	库请求。
NTMS_OPREQUEST	操作员请求。

[in] dwCount

列表中的请求数。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝向计算机NTMS_MODIFY_ACCESS。其他安全错误也可能存在，但它们表示存在安全子系统错误。 Windowsxp：拒绝向计算机NTMS_CONTROL_ACCESS。其他安全错误也可能存在，但它们表示存在安全子系统错误。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_DATABASE_FULL	数据库已满。
ERROR_INVALID_PARAMETER	类型标识符无效。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_NOT_ENOUGH_MEMORY	处理期间内存分配失败。
ERROR_SUCCESS	函数已成功执行。

如果未找到请求或请求列表，则不会返回错误。