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

Статья
11/20/2024

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

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

Синтаксис

typedef struct _NTMS_LIBREQUESTINFORMATIONA {
  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;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONA;

Члены

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	Операция успешно завершена.
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

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