SubmitNtmsOperatorRequestA 函数（ntmsapi.h）

项目
11/20/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库。 Windows XP：无需任何访问权限。
NTMS_OPREQ_DEVICESERVICE	当更改器设备或驱动器遇到问题时，应用程序或 RSM 会向驱动器服务发送操作员请求。 lpArg1Id 参数指定需要服务的设备。此参数可以是 iedoor、库、物理媒体或驱动器标识符。需要NTMS_CONTROL_ACCESS库。 Windows XP：无需任何访问权限。
NTMS_OPREQ_MESSAGE	仅应用程序消息。需要NTMS_USE_ACCESS计算机。 Windows XP：无需任何访问权限。
NTMS_OPREQ_MOVEMEDIA	应用程序或 RSM 将操作员请求从一个库移动到另一个库，以便装载脱机媒体或将现有媒体弹出到脱机库。 lpArg1Id 参数指定必须移动的物理介质段，lpArg2Id 参数指定目标库。需要NTMS_CONTROL_ACCESS媒体池。 Windows XP：无需任何访问权限。
NTMS_OPREQ_NEWMEDIA	当没有媒体可用时，应用程序或 RSM 会向新媒体发送操作员请求。 lpArg1Id 参数指定媒体池对象，lpArg2Id 参数是要向其添加新媒体的可选库标识符。需要NTMS_CONTROL_ACCESS媒体池。 Windows XP：无需任何访问权限。

[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 设备服务。

NTMS_OPEREQ_MESSAGE值（在 dwRequest 参数中）是应用程序最常使用的请求类型。 RSM 无法使用NTMS_OPEREQ_MESSAGE。 RSM 根据需要使用其他请求类型。

注意

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

要求

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