NTMS_PARTITIONINFORMATION

The NTMS_PARTITIONINFORMATION structure defines the properties specific to the side object.

typedef struct _NTMS_PARTITIONINFORMATION {
  NTMS_GUID      PhysicalMedia;
  NTMS_GUID      LogicalMedia;
  DWORD          State;
  WORD           Side;
  DWORD          dwOmidLabelIdLength;
  BYTE           OmidLabelId[255];
  TCHAR          szOmidLabelType[64];
  TCHAR          szOmidLabelInfo[256];
  DWORD          dwMountCount;
  DWORD          dwAllocateCount;
  LARGE_INTEGER  Capacity;
} NTMS_PARTITIONINFORMATION;

Members

PhysicalMedia

Unique physical media identifier for the medium that contains this side.

LogicalMedia

Unique logical media identifier for a piece of logical media that contains this side. This is a NULL ID if the side is not allocated.

State

Side life cycle information. This can be one of the following values.

Value	Meaning
NTMS_PARTSTATE_ALLOCATED	The media has been allocated to an application.
NTMS_PARTSTATE_AVAILABLE	The media is available to be allocated.
NTMS_PARTSTATE_COMPLETE	The media has been completely written and marked as complete by an application.
NTMS_PARTSTATE_DECOMMISIONED	The media is unsuitable for data storage and is no longer usable.
NTMS_PARTSTATE_INCOMPATIBLE	The media has been found to be and marked as incompatible with the drive.
NTMS_PARTSTATE_FOREIGN	The media is in a unrecognized pool.
NTMS_PARTSTATE_IMPORT	The media is in the import pool.
NTMS_PARTSTATE_UNPREPARED	The media is waiting for a free label to be applied.
NTMS_PARTSTATE_RESERVED	The side has been reserved by the AllocateNtmsMedia function with the dwOption parameter set to NTMS_ALLOCATE_NEW.

Side

A zero-relative value which indicates which side of a multi-sided media this is. For single-sided media, such as tape, this value is always zero. For dual-sided media one NTMS_PARITIONINFORMATION record has this property set to zero - the "A" side - and a second NTMS_PARTITIONINFORMATION record has it set to 1 - the "B" side.

dwOmidLabelIdLength

The length of the label ID string of the on-media identifier.

OmidLabelId

The label ID unique identifier of the on-media identifier.

szOmidLabelType

A string representing the label type of the on-media identifier.

szOmidLabelInfo

A string representing the label information of the on-media identifier.

dwMountCount

Number of times this media has been mounted into a drive. This is initialized to zero when the objects are created in the database.

dwAllocateCount

Number of times this media has been allocated.

Capacity

Number bytes of storage available on this side.

Remarks

The NTMS_PARTITIONINFORMATION data structure is part of the NTMS_OBJECTINFORMATION structure and is not used separately.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Ntmsapi.h.