NTMS_OPREQUESTINFORMATIONW结构(ntmsapi.h)

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

NTMS_OPREQUESTINFORMATION 结构定义特定于 RSM 操作员请求系统控制的属性。

语法

typedef struct _NTMS_OPREQUESTINFORMATIONW {
  DWORD      Request;
  SYSTEMTIME Submitted;
  DWORD      State;
  WCHAR      szMessage[NTMS_MESSAGE_LENGTH];
  DWORD      Arg1Type;
  NTMS_GUID  Arg1;
  DWORD      Arg2Type;
  NTMS_GUID  Arg2;
  WCHAR      szApplication[NTMS_APPLICATIONNAME_LENGTH];
  WCHAR      szUser[NTMS_USERNAME_LENGTH];
  WCHAR      szComputer[NTMS_COMPUTERNAME_LENGTH];
} NTMS_OPREQUESTINFORMATIONW;

成员

Request

运算符请求的类型。 这可以是以下值之一。

价值 意义
NTMS_OPREQ_NEWMEDIA
当没有媒体可用时,尝试分配媒体的应用程序会向新媒体发送操作员请求。 设置此标志时,应将 Arg1 成员设置为需要新媒体的媒体池的 GUID。 (可选)可以将 Arg2 成员设置为应放置新媒体的特定库。
NTMS_OPREQ_CLEANER
RSM 在清理操作排队且没有清洁器处于联机状态且可供驱动器使用时,向更清洁器发送操作员请求。 设置此标志后,应将 Arg1 成员设置为需要清理墨盒的库的 GUID。
NTMS_OPREQ_DEVICESERVICE
当更改器设备或驱动器遇到问题时,应用程序或 RSM 会向驱动器服务发送操作员请求。 设置此标志后,应将 Arg1 成员设置为需要服务的设备的 GUID。
NTMS_OPREQ_MOVEMEDIA
应用程序或 RSM 发送操作员请求,以将指定的介质移动到脱机媒体的装载,或将媒体弹出到脱机库。 设置此标志时,应将 Arg1 成员设置为要移动的物理介质的 GUID,Arg2 成员应设置为此媒体应移动到的库的 GUID。
NTMS_OPREQ_MESSAGE
特定于应用程序的操作员请求。 仅文本。

Submitted

提交操作员请求的系统时间。

State

操作员服务请求的当前状态。 这可以是以下值之一。

价值 意义
NTMS_OPSTATE_SUBMITTED
操作员请求已提交,但未由操作员控制台读取。
NTMS_OPSTATE_ACTIVE
操作员请求已由一个或多个操作员控制台读取,并且可能正在处理中。
NTMS_OPSTATE_INPROGRESS
用户已确认此操作员请求,并且正在执行服务。
NTMS_OPSTATE_REFUSED
用户已拒绝操作员服务请求。
NTMS_OPSTATE_COMPLETE
用户已完成操作员服务请求。

szMessage[NTMS_MESSAGE_LENGTH]

运算符消息文本。

Arg1Type

Arg1 对象的类型。 这可以是以下值之一。

价值 意义
NTMS_UNKNOWN
Arg1Type中未提供任何对象。
NTMS_CHANGER
中等更改器对象。
NTMS_DRIVE
Drive 对象。
NTMS_IEDOOR
库门对象。
NTMS_IEPORT。
库插入/弹出端口对象
NTMS_LIBRARY
库对象。
NTMS_PARTITION
侧对象。
NTMS_PHYSICAL_MEDIA
物理媒体对象。
NTMS_STORAGESLOT
库槽对象。

Arg1

Arg1 用于移动请求或其他需要引用对象的运算符请求的对象 ID。 此对象的用途因运算符请求的类型而异。 有关 Arg1的适当用途,请参阅 请求 说明。

Arg2Type

Arg2 对象的类型。 这可以是以下值之一。

价值 意义
NTMS_UNKNOWN
Arg2Type中未提供任何对象。
NTMS_LIBRARY
库对象。

Arg2

Arg2 对象 ID,用于需要第二个引用对象的运算符请求。 此对象的用途因运算符请求的类型而异。 有关 Arg2的适当用法,请参阅 请求 说明。

szApplication[NTMS_APPLICATIONNAME_LENGTH]

提交操作员请求的应用程序。

szUser[NTMS_USERNAME_LENGTH]

已登录到提交操作员请求的计算机的交互式用户。

szComputer[NTMS_COMPUTERNAME_LENGTH]

提交操作员请求的计算机。

言论

NTMS_OPREQUESTINFORMATION 结构包含在 NTMS_OBJECTINFORMATION 结构中。

注意

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

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
标头 ntmsapi.h

另请参阅

NTMS_OBJECTINFORMATION