NTMS_OPREQUESTINFORMATIONA 结构 (ntmsapi.h)

  • 项目

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

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

语法

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

成员

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
 驱动器对象。
NTMS_IEDOOR
 库门对象。
NTMS_IEPORT。
 库插入/弹出端口对象
NTMS_LIBRARY
 库对象。
NTMS_PARTITION
 Side 对象。
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