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

Статья
11/20/2024

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

Структура NTMS_PARTITIONINFORMATION определяет свойства, относящиеся к боковому объекту.

Синтаксис

typedef struct _NTMS_PARTITIONINFORMATIONW {
  NTMS_GUID     PhysicalMedia;
  NTMS_GUID     LogicalMedia;
  DWORD         State;
  WORD          Side;
  DWORD         dwOmidLabelIdLength;
  BYTE          OmidLabelId[NTMS_OMIDLABELID_LENGTH];
  WCHAR         szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH];
  WCHAR         szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH];
  DWORD         dwMountCount;
  DWORD         dwAllocateCount;
  LARGE_INTEGER Capacity;
} NTMS_PARTITIONINFORMATIONW;

Члены

PhysicalMedia

Уникальный идентификатор физического носителя для среды, содержащей эту сторону.

LogicalMedia

Уникальный идентификатор логического носителя (LMID) для части логического носителя, содержащего эту сторону. Этот параметр является NULL, если сторона не выделена.

State

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

Ценность	Значение
NTMS_PARTSTATE_ALLOCATED	Носитель был выделен приложению.
NTMS_PARTSTATE_AVAILABLE	Носитель доступен для выделения.
NTMS_PARTSTATE_COMPLETE	Носитель полностью написан и помечен как завершенный приложением.
NTMS_PARTSTATE_DECOMMISIONED	Носитель не подходит для хранения данных и больше не подходит для использования.
NTMS_PARTSTATE_INCOMPATIBLE	Носитель был найден и помечен как несовместимый с диском.
NTMS_PARTSTATE_FOREIGN	Носитель находится в нераспознанном пуле.
NTMS_PARTSTATE_IMPORT	Носитель находится в пуле импорта.
NTMS_PARTSTATE_UNPREPARED	Носитель ожидает применения бесплатной метки.
NTMS_PARTSTATE_RESERVED	Сторона зарезервирована функцией AllocateNtmsMedia с параметром dwOption значение NTMS_ALLOCATE_NEW.

Side

Отсчитываемое от нуля значение, указывающее, какая сторона мультисторонняя мультимедиа это. Для односторонного носителя, например ленты, это значение всегда равно нулю. Для двухсторонняя запись носителя одна NTMS_PARITIONINFORMATION имеет это свойство равно нулю — стороне "A", а вторая запись NTMS_PARTITIONINFORMATION имеет значение 1 - "B" боковой.

dwOmidLabelIdLength

Длина строки идентификатора метки идентификатора локального носителя.

OmidLabelId[NTMS_OMIDLABELID_LENGTH]

Идентификатор метки уникальный идентификатор идентификатора локального носителя.

szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH]

Тип метки идентификатора на носителе.

szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH]

Метка сведений об идентификаторе носителя.

dwMountCount

Количество раз, когда этот носитель был подключен к диску. Это инициализируется до нуля при создании объектов в базе данных.

dwAllocateCount

Количество раз, когда этот носитель выделен.

Capacity

Число байтов хранилища, доступного на этой стороне.

Замечания

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

Заметка

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

Требования

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

См. также

NTMS_OBJECTINFORMATION

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