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

Статья
11/20/2024

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

Структура NTMS_PMIDINFORMATION определяет свойства, относящиеся к объекту физического носителя.

Синтаксис

typedef struct _NTMS_PMIDINFORMATIONW {
  NTMS_GUID CurrentLibrary;
  NTMS_GUID MediaPool;
  NTMS_GUID Location;
  DWORD     LocationType;
  NTMS_GUID MediaType;
  NTMS_GUID HomeSlot;
  WCHAR     szBarCode[NTMS_BARCODE_LENGTH];
  DWORD     BarCodeState;
  WCHAR     szSequenceNumber[NTMS_SEQUENCE_LENGTH];
  DWORD     MediaState;
  DWORD     dwNumberOfPartitions;
  DWORD     dwMediaTypeCode;
  DWORD     dwDensityCode;
  NTMS_GUID MountedPartition;
} NTMS_PMIDINFORMATIONW;

Члены

CurrentLibrary

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

MediaPool

Уникальный идентификатор пула носителей, которому назначается носитель.

Location

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

LocationType

Текущий тип расположения части физического носителя. Для этого элемента можно задать значение NTMS_STORAGESLOT, NTMS_DRIVE, NTMS_IEPORT. (Автономный носитель находится в слотах.)

MediaType

Уникальный идентификатор объекта типа носителя.

HomeSlot

Уникальный идентификатор слота хранилища библиотеки, в котором хранится носитель.

szBarCode[NTMS_BARCODE_LENGTH]

Строка, соответствующая значению штрих-кода в метке штрих-кода физического носителя.

BarCodeState

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

Ценность	Значение
NTMS_BARCODESTATE_OK	Носитель имеет штрих-код и доступен для чтения.
NTMS_BARCODESTATE_UNREADABLE	Носитель либо не имеет штрих-кода, либо штрих-код недоступен.

szSequenceNumber[NTMS_SEQUENCE_LENGTH]

Последовательный номер, назначенный указанному носителю как удобочитаемое пользователем значение, которое должно быть транскрибировано пользователем на носителе, чтобы носитель можно было находить в автономной библиотеке.

MediaState

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

Ценность	Значение
NTMS_MEDIASTATE_IDLE	Носитель находится в слоте в библиотеке, в отключенном диске или в автономной библиотеке.
NTMS_MEDIASTATE_INUSE	Носитель помечен как используемый, как только запрос на операцию успешно выполняется в RSM.
NTMS_MEDIASTATE_LOADED	Состояние носителя, когда RSM определил, что носитель доступен для чтения и записи.
NTMS_MEDIASTATE_MOUNTED	Состояние физического носителя, когда носитель помещается в диск.
NTMS_MEDIASTATE_OP_ERROR	Физический носитель находится в состоянии ошибки, который можно восстановить. Никаких действий оператора не требуется.
NTMS_MEDIASTATE_UNLOADED	Состояние носителя, когда оно будет готово к удалению с диска. Состояние диска, DISMOUNTABLE, также указывает, что диск можно удалить в любое время.
NTMS_MEDIASTATE_OPREQ	Носитель ожидает запроса оператора.

dwNumberOfPartitions

Количество сторон на среднем.

dwMediaTypeCode

Код типа носителя SCSI.

dwDensityCode

Код плотности SCSI.

MountedPartition

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

Замечания

Структура NTMS_PMIDINFORMATION включается в структуру NTMS_OBJECTINFORMATION.

Заметка

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

Требования

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

См. также

NTMS_OBJECTINFORMATION

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