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

Статья
08/25/2023

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

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

Синтаксис

typedef struct _NTMS_OBJECTINFORMATIONW {
  DWORD      dwSize;
  DWORD      dwType;
  SYSTEMTIME Created;
  SYSTEMTIME Modified;
  NTMS_GUID  ObjectGuid;
  BOOL       Enabled;
  DWORD      dwOperationalState;
  WCHAR      szName[NTMS_OBJECTNAME_LENGTH];
  WCHAR      szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
  union {
    NTMS_DRIVEINFORMATIONW       Drive;
    NTMS_DRIVETYPEINFORMATIONW   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONW     Changer;
    NTMS_CHANGERTYPEINFORMATIONW ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONW        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONW   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONW  LibRequest;
    NTMS_OPREQUESTINFORMATIONW   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#else
  union {
    NTMS_DRIVEINFORMATIONW       Drive;
    NTMS_DRIVETYPEINFORMATIONW   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONW     Changer;
    NTMS_CHANGERTYPEINFORMATIONW ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONW        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONW   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONW  LibRequest;
    NTMS_OPREQUESTINFORMATIONW   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#endif
} NTMS_OBJECTINFORMATIONW, *LPNTMS_OBJECTINFORMATIONW;

Члены

dwSize

Тип: DWORD

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

dwType

Тип: DWORD

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

Значение	Значение
NTMS_CHANGER	Объект changer представляет роботизированный элемент единицы библиотеки. Элемент Info — это указатель на структуру NTMS_CHANGERINFORMATION .
NTMS_CHANGER_TYPE	Объект типа changer создается для каждого уникального типа устройства, подключенного к системе. Элемент Info является указателем на структуру NTMS_CHANGERTYPEINFORMATION .
NTMS_COMPUTER	Текущий объект компьютера. Структура для объекта-компьютера отсутствует. Элемент Info — это указатель на структуру NTMS_COMPUTERINFORMATION .
NTMS_DRIVE	Объект 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	Объект side представляет сторону части физического носителя. Элемент 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_OBJECTINFORMATIONW (ntmsapi.h)

Синтаксис

Члены

Комментарии

Требования

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

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

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

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