NTMS_PARTITIONINFORMATIONW structure (ntmsapi.h)
[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_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;
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 |
---|---|
|
The media has been allocated to an application. |
|
The media is available to be allocated. |
|
The media has been completely written and marked as complete by an application. |
|
The media is unsuitable for data storage and is no longer usable. |
|
The media has been found to be and marked as incompatible with the drive. |
|
The media is in a unrecognized pool. |
|
The media is in the import pool. |
|
The media is waiting for a free label to be applied. |
|
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[NTMS_OMIDLABELID_LENGTH]
Label ID unique identifier of the on-media identifier.
szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH]
Label type of the on-media identifier.
szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH]
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.
Note
The ntmsapi.h header defines NTMS_PARTITIONINFORMATION as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Header | ntmsapi.h |