NTMS_PARTITIONINFORMATIONA Struktur (ntmsapi.h)

Artikel
11/20/2024

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die NTMS_PARTITIONINFORMATION-Struktur definiert die für das seitenseitige Objekt spezifischen Eigenschaften.

Syntax

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

Angehörige

PhysicalMedia

Eindeutiger physischer Medienbezeichner für das Medium, das diese Seite enthält.

LogicalMedia

Eindeutige logische Medien-ID (LMID) für ein Teil logischer Medien, die diese Seite enthält. Dieser Parameter ist ein NULL-, wenn die Seite nicht zugeordnet ist.

State

Informationen zum Seitenlebenszyklus. Dies kann einer der folgenden Werte sein:

Wert	Bedeutung
NTMS_PARTSTATE_ALLOCATED	Die Medien wurden einer Anwendung zugewiesen.
NTMS_PARTSTATE_AVAILABLE	Die Medien sind verfügbar, die zugewiesen werden können.
NTMS_PARTSTATE_COMPLETE	Die Medien wurden vollständig geschrieben und durch eine Anwendung als vollständig gekennzeichnet.
NTMS_PARTSTATE_DECOMMISIONED	Die Medien sind für die Datenspeicherung ungeeignet und können nicht mehr verwendet werden.
NTMS_PARTSTATE_INCOMPATIBLE	Die Medien wurden gefunden und als nicht mit dem Laufwerk gekennzeichnet.
NTMS_PARTSTATE_FOREIGN	Die Medien befinden sich in einem nicht erkannten Pool.
NTMS_PARTSTATE_IMPORT	Das Medium befindet sich im Importpool.
NTMS_PARTSTATE_UNPREPARED	Die Medien warten auf die Anwendung einer kostenlosen Bezeichnung.
NTMS_PARTSTATE_RESERVED	Die Seite wurde von der funktion AllocateNtmsMedia reserviert, wobei der dwOption Parameter auf NTMS_ALLOCATE_NEW festgelegt ist.

Side

Nullrelativer Wert, der angibt, welche Seite eines mehrseitigen Mediums dies ist. Bei einseitigen Medien, z. B. Band, ist dieser Wert immer null. Bei dualseitigen Medien hat ein NTMS_PARITIONINFORMATION Datensatz diese Eigenschaft auf Null festgelegt - die "A"-Seite - und ein zweiter NTMS_PARTITIONINFORMATION Datensatz ist auf 1 festgelegt - die "B"-Seite.

dwOmidLabelIdLength

Länge der Bezeichnungs-ID-Zeichenfolge des On-Media-Bezeichners.

OmidLabelId[NTMS_OMIDLABELID_LENGTH]

Eindeutiger Bezeichner der Bezeichnungs-ID des On-Media-Bezeichners.

szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH]

Beschriftungstyp der On-Media-ID.

szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH]

Bezeichnungsinformationen des Bezeichners "On-Media".

dwMountCount

Häufigkeit, mit der diese Medien in ein Laufwerk eingebunden wurden. Dies wird auf Null initialisiert, wenn die Objekte in der Datenbank erstellt werden.

dwAllocateCount

Anzahl der Zuweisungen dieser Medien.

Capacity

Anzahl der auf dieser Seite verfügbaren Speicherbytes.

Bemerkungen

Die NTMS_PARTITIONINFORMATION Struktur ist in der NTMS_OBJECTINFORMATION Struktur enthalten.

Anmerkung

Der ntmsapi.h-Header definiert NTMS_PARTITIONINFORMATION als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	ntmsapi.h

Siehe auch

NTMS_OBJECTINFORMATION

Freigeben über