NTMS_OBJECTINFORMATIONA-Struktur (ntmsapi.h)
[Wechseldatenträger-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]
Die NTMS_OBJECTINFORMATION-Struktur definiert die Eigenschaften, die eine Anwendung für RSM-Geräte, Medien und Systemsteuerelemente (z. B. Bibliotheken, Laufwerke, Medien, Operatoranforderungen) abrufen und festlegen kann. Dies ist die allgemeine Struktur von Objekten in der RSM-Datenbank.
Syntax
typedef struct _NTMS_OBJECTINFORMATIONA {
DWORD dwSize;
DWORD dwType;
SYSTEMTIME Created;
SYSTEMTIME Modified;
NTMS_GUID ObjectGuid;
BOOL Enabled;
DWORD dwOperationalState;
CHAR szName[NTMS_OBJECTNAME_LENGTH];
CHAR szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
union {
NTMS_DRIVEINFORMATIONA Drive;
NTMS_DRIVETYPEINFORMATIONA DriveType;
NTMS_LIBRARYINFORMATION Library;
NTMS_CHANGERINFORMATIONA Changer;
NTMS_CHANGERTYPEINFORMATIONA ChangerType;
NTMS_STORAGESLOTINFORMATION StorageSlot;
NTMS_IEDOORINFORMATION IEDoor;
NTMS_IEPORTINFORMATION IEPort;
NTMS_PMIDINFORMATIONA PhysicalMedia;
NTMS_LMIDINFORMATION LogicalMedia;
NTMS_PARTITIONINFORMATIONA Partition;
NTMS_MEDIAPOOLINFORMATION MediaPool;
NTMS_MEDIATYPEINFORMATION MediaType;
NTMS_LIBREQUESTINFORMATIONA LibRequest;
NTMS_OPREQUESTINFORMATIONA OpRequest;
NTMS_COMPUTERINFORMATION Computer;
} Info;
#else
union {
NTMS_DRIVEINFORMATIONA Drive;
NTMS_DRIVETYPEINFORMATIONA DriveType;
NTMS_LIBRARYINFORMATION Library;
NTMS_CHANGERINFORMATIONA Changer;
NTMS_CHANGERTYPEINFORMATIONA ChangerType;
NTMS_STORAGESLOTINFORMATION StorageSlot;
NTMS_IEDOORINFORMATION IEDoor;
NTMS_IEPORTINFORMATION IEPort;
NTMS_PMIDINFORMATIONA PhysicalMedia;
NTMS_LMIDINFORMATION LogicalMedia;
NTMS_PARTITIONINFORMATIONA Partition;
NTMS_MEDIAPOOLINFORMATION MediaPool;
NTMS_MEDIATYPEINFORMATION MediaType;
NTMS_LIBREQUESTINFORMATIONA LibRequest;
NTMS_OPREQUESTINFORMATIONA OpRequest;
NTMS_COMPUTERINFORMATION Computer;
} Info;
#endif
} NTMS_OBJECTINFORMATIONA, *LPNTMS_OBJECTINFORMATIONA;
Member
dwSize
Art: DWORD
Größe der Informationsstruktur in Bytes. Dieses Element muss auf die richtige Größe der Struktur festgelegt werden, bevor die GetNtmsObjectInformation-Funktion oder die SetNtmsObjectInformation-Funktion verwendet wird.
dwType
Art: DWORD
Typ des Geräte- oder Systemsteuerelements, für das Informationen abgerufen/festgelegt werden sollen. Dieser Member muss auf einen der folgenden Werte festgelegt werden.
| Wert | Bedeutung |
|---|---|
|
Ein Changerobjekt stellt das Roboterelement einer Bibliothekseinheit dar. Das Info-Element ist ein Zeiger auf eine NTMS_CHANGERINFORMATION Struktur. |
|
Ein Changertypobjekt wird für jeden eindeutigen Changergerätetyp erstellt, der an ein System angefügt ist. Das Info-Element ist ein Zeiger auf eine NTMS_CHANGERTYPEINFORMATION Struktur. |
|
Das aktuelle Computerobjekt. Es gibt keine Struktur für das Computerobjekt. Das Info-Element ist ein Zeiger auf eine NTMS_COMPUTERINFORMATION-Struktur . |
|
Ein Laufwerkobjekt stellt ein Band- oder Datenträgerlaufwerk dar. Das Info-Element ist ein Zeiger auf eine NTMS_DRIVEINFORMATION Struktur. |
|
Für jeden eindeutigen Laufwerkgerätetyp, der an ein System angefügt ist, wird ein Laufwerktypobjekt erstellt. Das Info-Element ist ein Zeiger auf eine NTMS_DRIVETYPEINFORMATION-Struktur . |
|
Ein NTMS_IEDOOR-Objekt stellt den Türzugriffsmechanismus einer Bibliothekseinheit dar. Das Info-Element ist ein Zeiger auf eine NTMS_IEDOORINFORMATION-Struktur . |
|
Ein NTMS_IEPORT-Objekt stellt den Ein-/Auswurfport einer Bibliothekseinheit dar. Das Info-Element ist ein Zeiger auf eine NTMS_IEPORTINFORMATION-Struktur . |
|
Ein Bibliotheksobjekt stellt eine Online- oder Offlinebibliothek dar. Das Info-Element ist ein Zeiger auf eine NTMS_LIBRARYINFORMATION-Struktur . |
|
Für jede Anforderung für eine Bibliothek zum Ausführen einer Aktion wird ein Bibliotheksanforderungsobjekt erstellt. Eine Liste der Bibliotheksanforderungen wird von RSM als Warteschlange der auszuführenden Arbeit verwaltet. Das Info-Element ist ein Zeiger auf eine NTMS_LIBREQUESTINFORMATION Struktur. |
|
Das primäre Handle, das von Anwendungen für den Zugriff auf das angegebene Medium verwendet wird. Bei mehrseitigen Medien wird jede Seite als einzelnes Stück physischer Medien behandelt. Das Info-Element ist ein Zeiger auf eine NTMS_LMIDINFORMATION-Struktur . |
|
Ein Medienpool ist eine logische Gruppierung von Medien. Alle Medien in einem Medienpool müssen denselben Medientyp aufweisen. Das Info-Element ist ein Zeiger auf eine NTMS_MEDIAPOOLINFORMATION-Struktur . |
|
Für jeden eindeutigen Medientyp in einem System wird ein Medientypobjekt erstellt. Das Info-Element ist ein Zeiger auf eine NTMS_MEDIATYPEINFORMATION Struktur. |
|
Ein Operatoranforderungsobjekt stellt eine RSM-Anforderung für einen Benutzer dar, um die Informationen abzurufen. Das Info-Element ist ein Zeiger auf eine NTMS_OPREQUESTINFORMATION-Struktur . |
|
Ein seitenseitiges Objekt stellt eine Seite eines Stücks physischer Medien dar. Das Info-Element ist ein Zeiger auf eine NTMS_PARTITIONINFORMATION Struktur. |
|
Ein physisches Medienobjekt stellt ein Magnetband oder einen Wechseldatenträger dar. Ein Teil physischer Medien kann eine oder mehrere Seiten enthalten. Das Info-Element ist ein Zeiger auf eine NTMS_PMIDINFORMATION Struktur. |
|
Ein Speicherslotobjekt stellt einen der Slots dar, die das angegebene Medium in einer Bibliothek aufnehmen können. Das Info-Element ist ein Zeiger auf eine NTMS_STORAGESLOTINFORMATION Struktur. |
Created
Typ: SYSTEMTIME
Datums-/Uhrzeitstempel beim Erstellen des Objekts.
Modified
Typ: SYSTEMTIME
Datums-/Uhrzeitstempel beim Ändern des Objekts.
ObjectGuid
Typ: NTMS_GUID
GUID des Objekts.
Enabled
Typ: BOOL
Gibt an, ob das Geräte- oder Systemsteuerungsobjekt aktiviert ist.
dwOperationalState
Art: DWORD
Definiert den aktuellen Betriebszustand des Objekts. Dies kann einer der folgenden Werte sein.
szName[NTMS_OBJECTNAME_LENGTH]
Typ: TCHAR[NTMS_OBJECTNAME_LENGTH]
Name des Medien-, Geräte- oder Systemsteuerungsobjekts. Medienpool- und logische Mediennamen können mithilfe der Funktion SetNtmsObjectInformation geändert werden. Alle anderen Objektnamen sind schreibgeschützt.
szDescription[NTMS_DESCRIPTION_LENGTH]
Typ: TCHAR[NTMS_DESCRIPTION_LENGTH]
Beschreibung des Geräte- oder Systemsteuerungsobjekts. Die Beschreibung der Geräte- und Systemsteuerungsobjekte kann mithilfe der Funktion SetNtmsObjectInformation geändert werden. (Schreibbar für alle Objekte)
Info
Objektspezifische Informationen zur Geräte- oder Systemsteuerung. Das Format dieser Informationen hängt vom dwType-Element ab.
Info.Drive
Typ: NTMS_DRIVEINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_DRIVE ist.
Info.DriveType
Typ: NTMS_DRIVETYPEINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_DRIVE_TYPE ist.
Info.Library
Typ: NTMS_LIBRARYINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_LIBRARY ist.
Info.Changer
Typ: NTMS_CHANGERINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_CHANGER ist.
Info.ChangerType
Typ: NTMS_CHANGERTYPEINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_CHANGER_TYPE ist.
Info.StorageSlot
Typ: NTMS_STORAGESLOTINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_STORAGESLOT ist.
Info.IEDoor
Typ: NTMS_IEDOORINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_IEDOOR ist.
Info.IEPort
Typ: NTMS_IEPORTINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_IEPORT ist.
Info.PhysicalMedia
Typ: NTMS_PMIDINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_PHYSICAL_MEDIA ist.
Info.LogicalMedia
Typ: NTMS_LMIDINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_LOGICAL_MEDIA ist.
Info.Partition
Typ: NTMS_PARTITIONINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_PARTITION ist.
Info.MediaPool
Typ: NTMS_MEDIAPOOLINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_MEDIA_POOL ist.
Info.MediaType
Typ: NTMS_MEDIATYPEINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_MEDIA_TYPE ist.
Info.LibRequest
Typ: NTMS_LIBREQUESTINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_LIBREQUEST ist.
Info.OpRequest
Typ: NTMS_OPREQUESTINFORMATION Dieses Format wird verwendet, wenn der dwType-WertNTMS_OPREQUEST ist.
Info.Computer
Hinweise
Alle Member der NTMS_OBJECTINFORMATION-Struktur sind auf RSM-Funktionsebene schreibgeschützt, sofern in der Definition des Members nicht als WRITABLE angegeben.
Hinweis
Der ntmsapi.h-Header definiert NTMS_OBJECTINFORMATION 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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter: https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für