NTMS_PARTITIONINFORMATION Structure

  • Article

[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]

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

Syntax

typedef struct _NTMS_PARTITIONINFORMATION {
  NTMS_GUID     PhysicalMedia;
  NTMS_GUID     LogicalMedia;
  DWORD         State;
  WORD          Side;
  DWORD         dwOmidLabelIdLength;
  BYTE          OmidLabelId[NTMS_OMIDLABELID_LENGTH];
  TCHAR         szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH];
  TCHAR         szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH];
  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 (LMID) for a piece of logical media that contains this side. This parameter is a NULL 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
    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
    Length of the label ID string of the on-media identifier.

  • OmidLabelId
    Label ID unique identifier of the on-media identifier.

  • szOmidLabelType
    Label type of the on-media identifier.

  • szOmidLabelInfo
    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 structure is included in the NTMS_OBJECTINFORMATION structure.

Requirements

Minimum supported client

 Windows 2000 Professional

Minimum supported server

 Windows 2000 Server

End of client support

 Windows Vista

End of server support

 Windows Server 2008

Header

 Ntmsapi.h

See Also

NTMS_OBJECTINFORMATION

 

 

Send comments about this topic to Microsoft

Build date: 6/9/2011