SubmitNtmsOperatorRequestA 函数 (ntmsapi.h)

项目
02/29/2024

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

SubmitNtmsOperatorRequest 函数提交 RSM 运算符请求。

语法

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

参数

[in] hSession

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

[in] dwRequest

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

值	含义
NTMS_OPREQ_CLEANER	当清理操作排队且驱动器没有可用的清理程序时，RSM 发送操作员请求插入清理器。 lpArg1Id 参数可以是库或槽标识符。需要NTMS_CONTROL_ACCESS库。 Windowsxp：无需任何访问权限。
NTMS_OPREQ_DEVICESERVICE	当更换器设备或驱动器出现问题时，应用程序或 RSM 会发送操作员对驱动器服务的请求。 lpArg1Id 参数指定需要服务的设备。此参数可以是 iedoor、库、物理媒体或驱动器标识符。需要NTMS_CONTROL_ACCESS库。 Windowsxp：无需任何访问权限。
NTMS_OPREQ_MESSAGE	仅应用程序消息。需要NTMS_USE_ACCESS计算机。 Windowsxp：无需任何访问权限。
NTMS_OPREQ_MOVEMEDIA	应用程序或 RSM 发送操作员请求，要求将媒体从一个库移动到另一个库，以便装载脱机媒体或将现有媒体弹出到脱机库。 lpArg1Id 参数指定必须移动的物理介质片段，lpArg2Id 参数指定目标库。需要NTMS_CONTROL_ACCESS媒体池。 Windowsxp：无需任何访问权限。
NTMS_OPREQ_NEWMEDIA	当没有可用的媒体时，应用程序或 RSM 会发送对新媒体的操作员请求。 lpArg1Id 参数指定媒体池对象，lpArg2Id 参数是向其添加新媒体的可选库标识符。需要NTMS_CONTROL_ACCESS媒体池。 Windowsxp：无需任何访问权限。

[in] lpMessage

要发送给用户的可选消息字符串。

[in] lpArg1Id

运算符请求的对象标识符。有关必须为此参数传递哪种类型的对象的说明，请参阅 dwRequest 参数中值的说明。

[in] lpArg2Id

运算符请求的对象标识符。有关必须为此参数传递的对象类型的详细信息，请参阅 dwRequest 参数中值的说明。

[out] lpRequestId

指向接收已创建的操作员请求的标识符的缓冲区的指针。

返回值

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝访问一个或多个 RSM 对象。
ERROR_DATABASE_FAILURE	数据库查询或更新失败。
ERROR_INVALID_HANDLE	hSession 参数中指定的值为 NULL 或无效。
ERROR_INVALID_PARAMETER	其中一个参数值无效。
ERROR_NOT_CONNECTED	无法连接到 RSM 服务。
ERROR_OBJECT_NOT_FOUND	找不到源或目标对象。
ERROR_SUCCESS	函数成功。

注解

SubmitNtmsOperatorRequest 函数提交一个运算符请求，如果操作员不对请求) 执行操作，则返回请求的状态 (“满足”或“已取消”) 或超时 (。操作员请求用于请求媒体、请求将指定的媒体从一个库移到另一个库，或请求 RSM 设备服务。

dwRequest 参数) 中 (NTMS_OPEREQ_MESSAGE值是应用程序最常用的请求类型。 RSM 不能使用NTMS_OPEREQ_MESSAGE。 RSM 根据需要使用其他请求类型。

注意

ntmsapi.h 标头将 SubmitNtmsOperatorRequest 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

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