2.2.4.29 NTMS_PARTITIONINFORMATIONA Structure

  • Article

The NTMS_PARTITIONINFORMATIONA structure describes the properties of a media side object, as a sequence of ASCII characters.

 typedef struct _NTMS_PARTITIONINFORMATIONA {
   NTMS_GUID PhysicalMedia;
   NTMS_GUID LogicalMedia;
   DWORD State;
   unsigned short Side;
   DWORD dwOmidLabelIdLength;
   byte OmidLabelId[255];
   char szOmidLabelType[64];
   char szOmidLabelInfo[256];
   DWORD dwMountCount;
   DWORD dwAllocateCount;
   LARGE_INTEGER Capacity;
 } NTMS_PARTITIONINFORMATIONA;

PhysicalMedia: The identifier of the medium that contains the side.

LogicalMedia: The identifier of the piece of logical media that contains the side. This MUST be set to 0 if the side is not allocated.

Value

Meaning

0

The side is not allocated.

State: The value from the NtmsPartitionState (section 2.2.4.7) enumeration describing the state of the side.

Side: A zero-relative value that indicates which side of a multisided media this is. For single-sided media, this value MUST be 0. For dual-sided media, one NTMS_PARTITIONINFORMATIONA record MUST have its member set to 0, and a second NTMS_PARTITIONINFORMATIONA record MUST have its member set to 1.

Media\Value

Meaning

0

The only side of single-sided media, or the first side of dual-sided media.

1

The second side of dual-sided media.

dwOmidLabelIdLength: The length of the label identification string of the on-media identifier.

OmidLabelId: The label identifier of the on-media identifier.

szOmidLabelType: A null-terminated sequence of ASCII characters specifying the label type of the on-media identifier.

szOmidLabelInfo: A null-terminated sequence of ASCII characters specifying the label information of the on-media identifier.

dwMountCount: The number of times the medium has been mounted into a drive since being initialized for this server. This member MUST be initialized to 0 when the object is created in the database.

dwAllocateCount: The number of times the medium has been allocated since being initialized for this server.

Capacity: The number of bytes available on this side.