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

  • Статья

[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]

Структура NTMS_LIBREQUESTINFORMATION определяет свойства, относящиеся к рабочему запросу, которые помещаются в очередь в RSM.

Синтаксис

typedef struct _NTMS_LIBREQUESTINFORMATIONW {
  DWORD      OperationCode;
  DWORD      OperationOption;
  DWORD      State;
  NTMS_GUID  PartitionId;
  NTMS_GUID  DriveId;
  NTMS_GUID  PhysMediaId;
  NTMS_GUID  Library;
  NTMS_GUID  SlotId;
  SYSTEMTIME TimeQueued;
  SYSTEMTIME TimeCompleted;
  WCHAR      szApplication[NTMS_APPLICATIONNAME_LENGTH];
  WCHAR      szUser[NTMS_USERNAME_LENGTH];
  WCHAR      szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONW;

Члены

OperationCode

Операция с элементом. Это может быть одно из следующих значений.

Значение Значение
NTMS_LM_CLASSIFY
 Классифицируйте среду.
NTMS_LM_CLEANDRIVE
 Очистка диска.
NTMS_LM_DISABLELIBRARY
 Отключите средство изменения.
NTMS_LM_DISABLEDRIVE
 Отключение диска.
NTMS_LM_DISABLEMEDIA
 Отключите среду.
NTMS_LM_DISMOUNT
 Отключите среду от диска.
NTMS_LM_DOORACCESS
 Разрешите доступ к мультимедиа через дверь блока библиотеки.
NTMS_LM_EJECT
 Извлеките носитель из библиотеки.
NTMS_LM_EJECTCLEANER
 Выброшенный уборщик.
NTMS_LM_ENABLELIBRARY
 Включите средство изменения.
NTMS_LM_ENABLEDRIVE
 Включите диск.
NTMS_LM_ENABLEMEDIA
 Включите среду.
NTMS_LM_INJECT
 Вставьте носитель в библиотеку.
NTMS_LM_INJECTCLEANER
 Вставьте средство очистки.
NTMS_LM_INVENTORY
 Выполните инвентаризацию библиотеки.
NTMS_LM_MOUNT
 Подключите сторону к диску.
NTMS_LM_PROCESSOMID
 Обработайте OMID.
NTMS_LM_RELEASECLEANER
 Отпустите слот для очистки.
NTMS_LM_REMOVE
 Удаление рабочего элемента из очереди.
NTMS_LM_RESERVECLEANER
 Зарезервируйте слот для очистки.
NTMS_LM_UPDATEOMID
 Обновите OMID.
NTMS_LM_WRITESCRATCH
 Напишите бесплатную метку.

OperationOption

Параметры рабочих элементов (для конкретных команд).

State

Текущее состояние этого рабочего элемента. Это может быть одно из следующих значений.

Значение Значение
NTMS_LM_QUEUED
 Операция поставлена в очередь.
NTMS_LM_INPROCESS
 Операция обрабатывается.
NTMS_LM_PASSED
 Operation completed successfully (Операция выполнена успешно).
NTMS_LM_FAILED
 Операция завершилась с ошибкой.
NTMS_LM_WAITING
 Операция заблокирована.
NTMS_LM_CANCELLED
 Операция отменена.
NTMS_LM_INVALID
 Операция недопустима.

PartitionId

Уникальный идентификатор обслуживаемой стороны.

DriveId

Уникальный идентификатор обслуживаемого диска.

PhysMediaId

Уникальный идентификатор обслуживаемого физического носителя.

Library

Библиотека для этого запроса.

SlotId

Уникальный идентификатор слота обслуживаемого физического носителя.

TimeQueued

Системное время постановки этого запроса в очередь в RSM.

TimeCompleted

Системное время выполнения этого запроса с помощью RSM.

szApplication[NTMS_APPLICATIONNAME_LENGTH]

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

szUser[NTMS_USERNAME_LENGTH]

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

szComputer[NTMS_COMPUTERNAME_LENGTH]

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

dwErrorCode

Ошибка возврата для запросов, возвращаемых с состоянием NTMS_LM_FAILED. Это системный код ошибки.

WorkItemId

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

dwPriority

Приоритет рабочего элемента.

Комментарии

Структура NTMS_LIBREQUESTINFORMATION включена в структуру NTMS_OBJECTINFORMATION .

Guid в рабочее время может стать недопустимым со временем. Например, при извлечении свободного носителя pmID удаляется после извлечения носителя. Однако рабочий элемент не обновляется после завершения извлечения.

Примечание

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

Требования

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

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

NTMS_OBJECTINFORMATION