NTMS_PMIDINFORMATIONW-Struktur (ntmsapi.h)

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

Die NTMS_PMIDINFORMATION-Struktur definiert die Spezifischen Eigenschaften für ein physisches Medienobjekt.

Syntax

typedef struct _NTMS_PMIDINFORMATIONW {
  NTMS_GUID CurrentLibrary;
  NTMS_GUID MediaPool;
  NTMS_GUID Location;
  DWORD     LocationType;
  NTMS_GUID MediaType;
  NTMS_GUID HomeSlot;
  WCHAR     szBarCode[NTMS_BARCODE_LENGTH];
  DWORD     BarCodeState;
  WCHAR     szSequenceNumber[NTMS_SEQUENCE_LENGTH];
  DWORD     MediaState;
  DWORD     dwNumberOfPartitions;
  DWORD     dwMediaTypeCode;
  DWORD     dwDensityCode;
  NTMS_GUID MountedPartition;
} NTMS_PMIDINFORMATIONW;

Member

CurrentLibrary

Eindeutige ID der Bibliothek, in der sich die Medien befinden.

MediaPool

Eindeutige ID des Medienpools, dem die Medien zugewiesen sind.

Location

Eindeutige ID des physischen Standortobjekts für die Medien.

LocationType

Aktueller Standorttyp eines Stücks physischer Medien. Der Wert dieses Members kann auf NTMS_STORAGESLOT, NTMS_DRIVE, NTMS_IEPORT festgelegt werden. (Offlinemedien befinden sich in Slots.)

MediaType

Eindeutige ID eines Medientypobjekts.

HomeSlot

Eindeutige ID des Speicherslots der Bibliothek, in dem Medien gespeichert sind.

szBarCode[NTMS_BARCODE_LENGTH]

Zeichenfolge, die mit dem Barcodewert auf einer Barcodebeschriftung eines Physischen Mediums übereinstimmt.

BarCodeState

Aktueller Status des Barcodes. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
NTMS_BARCODESTATE_OK	Die Medien verfügen über einen Barcode und sind lesbar.
NTMS_BARCODESTATE_UNREADABLE	Die Medien verfügen entweder nicht über einen Barcode, oder der Barcode ist nicht lesbar.

szSequenceNumber[NTMS_SEQUENCE_LENGTH]

Sequenzielle Nummer, die dem angegebenen Medium als für Menschen lesbarer Wert zugewiesen ist und von einem Benutzer auf dem Medium transkribiert werden muss, damit das Medium in einer Offlinebibliothek gefunden werden kann.

MediaState

Aktueller Zustand für den Teil der physischen Medien. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
NTMS_MEDIASTATE_IDLE	Die Medien befinden sich in einem Slot in der Bibliothek, in einem Laufwerk, das nicht bereitgestellt wurde, oder in einer Offlinebibliothek.
NTMS_MEDIASTATE_INUSE	Die Medien werden als verwendet markiert, sobald eine Anforderung für einen Vorgang erfolgreich an RSM gestellt wurde.
NTMS_MEDIASTATE_LOADED	Der Zustand der Medien, wenn RSM ermittelt hat, dass die Medien zum Lesen und Schreiben verfügbar sind.
NTMS_MEDIASTATE_MOUNTED	Der Zustand eines Physischen Medienteils, wenn die Medien auf einem Laufwerk platziert werden.
NTMS_MEDIASTATE_OP_ERROR	Die physischen Medien befinden sich in einem Fehlerzustand, der wiederhergestellt werden kann. Es ist kein Operatoreingriff erforderlich.
NTMS_MEDIASTATE_UNLOADED	Der Zustand des Mediums, wenn es bereit ist, von einem Laufwerk entfernt zu werden. Der Laufwerkszustand DISMOUNTABLE gibt auch an, dass ein Laufwerk jederzeit entfernt werden kann.
NTMS_MEDIASTATE_OPREQ	Medien warten auf Operatoranforderung.

dwNumberOfPartitions

Anzahl der Seiten auf dem Medium.

dwMediaTypeCode

SCSI-Medientypcode.

dwDensityCode

SCSI-Dichtecode.

MountedPartition

Global eindeutige ID der Seite des Mediens, das derzeit eingebunden wird.

Hinweise

Die NTMS_PMIDINFORMATION-Struktur ist in der NTMS_OBJECTINFORMATION-Struktur enthalten.

Hinweis

Der ntmsapi.h-Header definiert NTMS_PMIDINFORMATION 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	ntmsapi.h

Weitere Informationen

NTMS_OBJECTINFORMATION