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

Статья
08/25/2023

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

Структура NTMS_OBJECTINFORMATION определяет свойства, которые приложение может получить и задать для устройств RSM, мультимедиа и системных элементов управления (таких как библиотеки, диски, мультимедиа, запросы оператора). Это общая структура объектов в базе данных RSM.

Синтаксис

typedef struct _NTMS_OBJECTINFORMATIONA {
  DWORD      dwSize;
  DWORD      dwType;
  SYSTEMTIME Created;
  SYSTEMTIME Modified;
  NTMS_GUID  ObjectGuid;
  BOOL       Enabled;
  DWORD      dwOperationalState;
  CHAR       szName[NTMS_OBJECTNAME_LENGTH];
  CHAR       szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
  union {
    NTMS_DRIVEINFORMATIONA       Drive;
    NTMS_DRIVETYPEINFORMATIONA   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONA     Changer;
    NTMS_CHANGERTYPEINFORMATIONA ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONA        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONA   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONA  LibRequest;
    NTMS_OPREQUESTINFORMATIONA   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#else
  union {
    NTMS_DRIVEINFORMATIONA       Drive;
    NTMS_DRIVETYPEINFORMATIONA   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONA     Changer;
    NTMS_CHANGERTYPEINFORMATIONA ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONA        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONA   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONA  LibRequest;
    NTMS_OPREQUESTINFORMATIONA   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#endif
} NTMS_OBJECTINFORMATIONA, *LPNTMS_OBJECTINFORMATIONA;

Члены

dwSize

Тип: DWORD

Размер структуры информации в байтах. Перед использованием функции GetNtmsObjectInformation или SetNtmsObjectInformation для этого элемента необходимо задать правильный размер структуры.

dwType

Тип: DWORD

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

Значение	Значение
NTMS_CHANGER	Объект changer представляет роботизированный элемент единицы библиотеки. Элемент Info является указателем на структуру NTMS_CHANGERINFORMATION .
NTMS_CHANGER_TYPE	Объект типа смены создается для каждого уникального типа устройства, подключенного к системе. Элемент Info является указателем на структуру NTMS_CHANGERTYPEINFORMATION .
NTMS_COMPUTER	Текущий объект-компьютер. Структура для объекта-компьютера отсутствует. Элемент Info является указателем на структуру NTMS_COMPUTERINFORMATION .
NTMS_DRIVE	Объект диска представляет ленточный накопитель или диск. Элемент Info является указателем на структуру NTMS_DRIVEINFORMATION .
NTMS_DRIVE_TYPE	Объект типа диска создается для каждого уникального типа устройства диска, подключенного к системе. Элемент Info является указателем на структуру NTMS_DRIVETYPEINFORMATION .
NTMS_IEDOOR	Объект NTMS_IEDOOR представляет механизм доступа к дверям в блоке библиотеки. Элемент Info является указателем на структуру NTMS_IEDOORINFORMATION .
NTMS_IEPORT	Объект NTMS_IEPORT представляет порт вставки и извлечения единицы библиотеки. Элемент Info является указателем на структуру NTMS_IEPORTINFORMATION .
NTMS_LIBRARY	Объект библиотеки представляет интерактивную или автономную библиотеку. Элемент Info является указателем на структуру NTMS_LIBRARYINFORMATION .
NTMS_LIBREQUEST	Объект запроса библиотеки создается для каждого запроса библиотеки на выполнение действия. Список запросов библиотеки поддерживается RSM как очередь выполняемых работ. Элемент Info является указателем на структуру NTMS_LIBREQUESTINFORMATION .
NTMS_LOGICAL_MEDIA	Основной дескриптор, используемый приложениями для доступа к указанному носителю. В случае с многосторонним носителем каждая сторона рассматривается как отдельный физический носитель. Элемент Info является указателем на структуру NTMS_LMIDINFORMATION .
NTMS_MEDIA_POOL	Пул носителей — это логическая группа носителей. Все носители в пуле носителей должны иметь один и тот же тип мультимедиа. Элемент Info является указателем на структуру NTMS_MEDIAPOOLINFORMATION .
NTMS_MEDIA_TYPE	Объект типа мультимедиа создается для каждого уникального типа мультимедиа в системе. Элемент Info является указателем на структуру NTMS_MEDIATYPEINFORMATION .
NTMS_OPREQUEST	Объект запроса оператора представляет запрос RSM для пользователя на получение сведений. Элемент Info является указателем на структуру NTMS_OPREQUESTINFORMATION .
NTMS_PARTITION	Боковой объект представляет сторону физического носителя. Элемент Info является указателем на структуру NTMS_PARTITIONINFORMATION .
NTMS_PHYSICAL_MEDIA	Физический объект носителя представляет собой магнитную ленту или съемный диск. Часть физического носителя может содержать одну или несколько сторон. Элемент Info является указателем на структуру NTMS_PMIDINFORMATION .
NTMS_STORAGESLOT	Объект слота хранилища представляет один из слотов, которые могут содержать указанный носитель в библиотеке. Элемент Info является указателем на структуру NTMS_STORAGESLOTINFORMATION .

Created

Тип: SYSTEMTIME

Метка даты и времени создания объекта.

Modified

Тип: SYSTEMTIME

Метка даты и времени изменения объекта.

ObjectGuid

Тип: NTMS_GUID

GUID объекта .

Enabled

Тип: BOOL

Указывает, включен ли объект управления устройством или системой.

dwOperationalState

Тип: DWORD

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

Значение	Значение
NTMS_NOT_PRESENT	Этого устройства или объекта в настоящее время нет.
NTMS_READY	Это устройство или объект доступны и готовы.
NTMS_NEEDS_SERVICE	Это устройство или объект завершилось сбоем и нуждается в обслуживании.

szName[NTMS_OBJECTNAME_LENGTH]

Тип: TCHAR[NTMS_OBJECTNAME_LENGTH]

Имя носителя, устройства или объекта системного элемента управления. Пул носителей и логические имена носителей можно изменить с помощью функции SetNtmsObjectInformation . Все остальные имена объектов доступны только для чтения.

szDescription[NTMS_DESCRIPTION_LENGTH]

Тип: TCHAR[NTMS_DESCRIPTION_LENGTH]

Описание устройства или объекта системного элемента управления. Описание объектов управления устройством и системой можно изменить с помощью функции SetNtmsObjectInformation . (запись для всех объектов)

Info

Сведения об объекте управления устройством или системой. Формат этих сведений зависит от члена dwType .

Info.Drive

Тип: NTMS_DRIVEINFORMATION Этот формат используется, если значение dwTypeравно NTMS_DRIVE.

Info.DriveType

Тип: NTMS_DRIVETYPEINFORMATION Этот формат используется, если значение dwTypeравно NTMS_DRIVE_TYPE.

Info.Library

Тип: NTMS_LIBRARYINFORMATION Этот формат используется, если значение dwTypeравно NTMS_LIBRARY.

Info.Changer

Тип: NTMS_CHANGERINFORMATION Этот формат используется, если значение dwTypeравно NTMS_CHANGER.

Info.ChangerType

Тип: NTMS_CHANGERTYPEINFORMATION Этот формат используется, если значение dwTypeNTMS_CHANGER_TYPE.

Info.StorageSlot

Тип: NTMS_STORAGESLOTINFORMATION Этот формат используется, если значение dwTypeравно NTMS_STORAGESLOT.

Info.IEDoor

Тип: NTMS_IEDOORINFORMATION Этот формат используется, если значение dwTypeравно NTMS_IEDOOR.

Info.IEPort

Тип: NTMS_IEPORTINFORMATION Этот формат используется, если значение dwTypeравно NTMS_IEPORT.

Info.PhysicalMedia

Тип: NTMS_PMIDINFORMATION Этот формат используется, если значение dwTypeNTMS_PHYSICAL_MEDIA.

Info.LogicalMedia

Тип: NTMS_LMIDINFORMATION Этот формат используется, если значение dwTypeравно NTMS_LOGICAL_MEDIA.

Info.Partition

Тип: NTMS_PARTITIONINFORMATION Этот формат используется, если значение dwTypeравно NTMS_PARTITION.

Info.MediaPool

Тип: NTMS_MEDIAPOOLINFORMATION Этот формат используется, если значение dwTypeравно NTMS_MEDIA_POOL.

Info.MediaType

Тип: NTMS_MEDIATYPEINFORMATION Этот формат используется, если значение dwTypeравно NTMS_MEDIA_TYPE.

Info.LibRequest

Тип: NTMS_LIBREQUESTINFORMATION Этот формат используется, если значение dwTypeравно NTMS_LIBREQUEST.

Info.OpRequest

Тип: NTMS_OPREQUESTINFORMATION Этот формат используется, если значение dwTypeNTMS_OPREQUEST.

Info.Computer

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

Требования

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

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

GetNtmsObjectInformation

SetNtmsObjectInformation

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

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

Синтаксис

Члены

Комментарии

Требования

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

Обратная связь

Дополнительные ресурсы