NTMS_PMIDINFORMATIONA Struktur (ntmsapi.h)

Artikel
11/20/2024

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

Die NTMS_PMIDINFORMATION-Struktur definiert die eigenschaften, die für ein physisches Medienobjekt spezifisch sind.

Syntax

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

Angehörige

CurrentLibrary

Eindeutige ID der Bibliothek, in der die Medien enthalten sind.

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 Elements kann auf NTMS_STORAGESLOT, NTMS_DRIVE, NTMS_IEPORT festgelegt werden. (Offlinemedien befinden sich in Slots.)

MediaType

Eindeutige ID eines Medientypobjekts.

HomeSlot

Eindeutige ID des Bibliotheksspeicherplatzes, in dem Medien gespeichert werden.

szBarCode[NTMS_BARCODE_LENGTH]

Zeichenfolge, die dem Barcodewert auf einer Barcodebeschriftung eines Physischen Mediums entspricht.

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 unlesbar.

szSequenceNumber[NTMS_SEQUENCE_LENGTH]

Sequenzielle Zahl, die dem angegebenen Medium als lesbarer Wert zugewiesen wird, der von einem Benutzer auf dem Medium transkribiert werden muss, damit sich das Medium in einer Offlinebibliothek befinden kann.

MediaState

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

Wert	Bedeutung
NTMS_MEDIASTATE_IDLE	Die Medien befinden sich in einem Steckplatz in der Bibliothek, in einem laufwerk dismounted oder in einer Offlinebibliothek.
NTMS_MEDIASTATE_INUSE	Die Medien werden als in Gebrauch markiert, sobald eine Anforderung für einen Vorgang erfolgreich an RSM gestellt wird.
NTMS_MEDIASTATE_LOADED	Der Status der Medien, wenn RSM festgestellt hat, dass die Medien zum Lesen und Schreiben verfügbar sind.
NTMS_MEDIASTATE_MOUNTED	Der Zustand eines Stücks physischer Medien, wenn die Medien in 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 Status des Mediums, wenn es bereit ist, aus einem Laufwerk zu entfernen. Der Laufwerkstatus DISMOUNTABLE gibt auch an, dass ein Laufwerk jederzeit entfernt werden kann.
NTMS_MEDIASTATE_OPREQ	Medien warten auf die Operatoranforderung.

dwNumberOfPartitions

Die Anzahl der Seiten auf dem Medium.

dwMediaTypeCode

SCSI-Medientypcode.

dwDensityCode

SCSI-Dichtecode.

MountedPartition

Globally unique ID of the side of the media that is currently mounted.

Bemerkungen

Die NTMS_PMIDINFORMATION Struktur ist in der NTMS_OBJECTINFORMATION Struktur enthalten.

Anmerkung

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
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