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

Статья
11/20/2024

[Диспетчер съемных носителей больше не доступен в 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 SetNtmsObjectInformation.

dwType

Тип: DWORD

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

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

Info.ChangerType

тип : NTMS_CHANGERTYPEINFORMATION этот формат используется, если значение dwType равно NTMS_CHANGER_TYPE.

Info.StorageSlot

тип : NTMS_STORAGESLOTINFORMATION этот формат используется, если значение dwTypeNTMS_STORAGESLOT.

Info.IEDoor

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

Info.IEPort

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

Info.PhysicalMedia

тип : NTMS_PMIDINFORMATION этот формат используется, если значение dwType равно NTMS_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 этот формат используется, если значение dwTypeNTMS_MEDIA_TYPE.

Info.LibRequest

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

Info.OpRequest

тип : NTMS_OPREQUESTINFORMATION этот формат используется, если значение dwType равно NTMS_OPREQUEST.

Info.Computer

Замечания

Все члены структуры NTMS_OBJECTINFORMATION доступны только для чтения на уровне функции RSM, если не указано как WRITABLE в определении элемента.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	ntmsapi.h

См. также

GetNtmsObjectInformation

SetNtmsObjectInformation

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

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

Синтаксис

Члены

Замечания

Требования

См. также

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

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