WaitForNtmsOperatorRequest 函数 (ntmsapi.h)

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

WaitForNtmsOperatorRequest 函数等待指定的 RSM 运算符请求。

语法

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

[in] hSession

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

[in] lpRequestId

由 SubmitNtmsOperatorRequest 函数创建的操作员请求标识符。

[in] dwTimeout

等待的毫秒数。若要为操作员请求检查，请传递零的超时值。如果指定 INFINITE 值，则此函数不会超时。

此函数返回以下值之一。

值	含义
ERROR_CANCELLED	管理员取消了操作员请求。
ERROR_INVALID_HANDLE	hSession 参数中指定的值为 NULL 或无效。
ERROR_INVALID_PARAMETER	其中一个参数值无效。
ERROR_NOT_CONNECTED	无法连接到 RSM 服务。
ERROR_OBJECT_NOT_FOUND	找不到运算符请求对象。从数据库刷新对象请求。如果 RSM 返回此错误，应用程序应调用类似 AllocateNtmsMedia 的函数。
ERROR_SUCCESS	函数成功。
ERROR_TIMEOUT	在 dwTimeout 参数中指定的时间，在运算符请求完成之前。

使用 WaitForNtmsOperatorRequest 函数指定的操作员请求用于请求媒体、请求媒体从一个库移动到另一个库，或请求 RSM 设备服务。

应用程序使用 WaitForNtmsOperatorRequest 等待操作员请求的解析。请求可以得到满足、拒绝、删除或超时。

通常，应用程序使用 SubmitNtmsOperatorRequest 函数提交操作员请求，并使用 WaitForNtmsOperatorRequest 函数等待其解决。