структура NTMS_OPREQUESTINFORMATIONW (ntmsapi.h)

Статья
11/20/2024

[Диспетчер съемных носителей больше не доступен в 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, используемый для запросов перемещения или других запросов операторов, требующих ссылочного объекта. Назначение этого объекта зависит от типа запроса оператора. Дополнительные сведения об использовании Arg1см. в описании запроса .

Arg2Type

Тип объекта Arg2. Это может быть одно из следующих значений.

Ценность	Значение
NTMS_UNKNOWN	Объект не указан в Arg2Type.
NTMS_LIBRARY	Объект библиотеки.

Arg2

идентификатор объекта Arg2, используемый для запросов операторов, требующих второго ссылочного объекта. Назначение этого объекта зависит от типа запроса оператора. Дополнительные сведения об использовании Arg2см. в описании запроса .

szApplication[NTMS_APPLICATIONNAME_LENGTH]

Приложение, отправив запрос оператора.

szUser[NTMS_USERNAME_LENGTH]

Интерактивный пользователь вошел на компьютер, отправив запрос оператора.

szComputer[NTMS_COMPUTERNAME_LENGTH]

Компьютер, отправив запрос оператора.

Замечания

Структура NTMS_OPREQUESTINFORMATION включается в структуру NTMS_OBJECTINFORMATION.

Заметка

Заголовок ntmsapi.h определяет NTMS_OPREQUESTINFORMATION как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	ntmsapi.h

См. также

NTMS_OBJECTINFORMATION

Поделиться через