структура 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
 Объект Drive.
NTMS_IEDOOR
 Объект двери библиотеки.
NTMS_IEPORT.
 Объект порта вставки и извлечения библиотеки
NTMS_LIBRARY
 Объект library.
NTMS_PARTITION
 Объект Side.
NTMS_PHYSICAL_MEDIA
 Физический объект мультимедиа.
NTMS_STORAGESLOT
 Объект слота библиотеки.

Arg1

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

Arg2Type

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

Значение Значение
NTMS_UNKNOWN
 Объект не указан в Arg2Type.
NTMS_LIBRARY
 Объект 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть ntmsapi.h

См. также раздел

NTMS_OBJECTINFORMATION