NTMS_OBJECTINFORMATIONA Struktur (ntmsapi.h)

Artikel
11/20/2024

[Wechselmedien-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;

Angehörige

dwSize

Typ: DWORD-

Größe der Informationsstruktur in Byte. Dieses Element muss vor der Verwendung der GetNtmsObjectInformation--Funktion oder der SetNtmsObjectInformation-Funktion auf die richtige Größe der Struktur festgelegt werden.

dwType

Typ: DWORD-

Typ des Geräte- oder Systemsteuerelements, für das Informationen abgerufen/festgelegt werden sollen. Dieses Element muss auf einen der folgenden Werte festgelegt werden.

Wert	Bedeutung
NTMS_CHANGER	Ein Changer-Objekt stellt das Roboterelement einer Bibliothekseinheit dar. Das Info-element ist ein Zeiger auf eine NTMS_CHANGERINFORMATION Struktur.
NTMS_CHANGER_TYPE	Ein Änderungstypobjekt wird für jeden eindeutigen Änderungsgerätetyp erstellt, der an ein System angeschlossen ist. Das Info-element ist ein Zeiger auf eine NTMS_CHANGERTYPEINFORMATION Struktur.
NTMS_COMPUTER	Das aktuelle Computerobjekt. Für das Computerobjekt gibt es keine Struktur. Das Info-element ist ein Zeiger auf eine NTMS_COMPUTERINFORMATION Struktur.
NTMS_DRIVE	Ein Laufwerkobjekt stellt ein Bandlaufwerk oder ein Laufwerk dar. Das Info-element ist ein Zeiger auf eine NTMS_DRIVEINFORMATION Struktur.
NTMS_DRIVE_TYPE	Ein Laufwerktypobjekt wird für jeden eindeutigen Laufwerkgerätetyp erstellt, der an ein System angefügt ist. Das Info-element ist ein Zeiger auf eine NTMS_DRIVETYPEINFORMATION Struktur.
NTMS_IEDOOR	Ein NTMS_IEDOOR-Objekt stellt den Türzugriffsmechanismus einer Bibliothekseinheit dar. Das Info-element ist ein Zeiger auf eine NTMS_IEDOORINFORMATION Struktur.
NTMS_IEPORT	Ein NTMS_IEPORT-Objekt stellt den Einfüge-/Auswurfport einer Bibliothekseinheit dar. Das Info-element ist ein Zeiger auf eine NTMS_IEPORTINFORMATION Struktur.
NTMS_LIBRARY	Ein Bibliotheksobjekt stellt eine Online- oder Offlinebibliothek dar. Das Info-element ist ein Zeiger auf eine NTMS_LIBRARYINFORMATION Struktur.
NTMS_LIBREQUEST	Für jede Anforderung einer Bibliothek zum Ausführen einer Aktion wird ein Bibliotheksanforderungsobjekt erstellt. Eine Liste der Bibliotheksanforderungen wird von RSM als Arbeitswarteschlange verwaltet, die ausgeführt werden soll. Das Info-element ist ein Zeiger auf eine NTMS_LIBREQUESTINFORMATION Struktur.
NTMS_LOGICAL_MEDIA	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.
NTMS_MEDIA_POOL	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.
NTMS_MEDIA_TYPE	Für jeden eindeutigen Medientyp in einem System wird ein Medientypobjekt erstellt. Das element Info ist ein Zeiger auf eine NTMS_MEDIATYPEINFORMATION Struktur.
NTMS_OPREQUEST	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.
NTMS_PARTITION	Ein Seitenobjekt stellt eine Seite eines Physischen Mediums dar. Das Info-element ist ein Zeiger auf eine NTMS_PARTITIONINFORMATION Struktur.
NTMS_PHYSICAL_MEDIA	Ein physisches Medienobjekt stellt ein Magnetband oder Wechseldatenträger dar. Ein Teil physischer Medien kann eine oder mehrere Seiten enthalten. Das Info-element ist ein Zeiger auf eine NTMS_PMIDINFORMATION Struktur.
NTMS_STORAGESLOT	Ein Speicherplatzobjekt stellt einen der Steckplätze dar, die das angegebene Medium in einer Bibliothek enthalten 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, zu dem das Objekt geändert wurde.

ObjectGuid

Typ: NTMS_GUID

GUID des Objekts.

Enabled

Typ: BOOL-

Gibt an, ob das Geräte- oder Systemsteuerungsobjekt aktiviert ist.

dwOperationalState

Typ: DWORD-

Definiert den aktuellen Betriebszustand des Objekts. Dies kann einer der folgenden Werte sein:

Wert	Bedeutung
NTMS_NOT_PRESENT	Dieses Gerät oder Objekt ist derzeit nicht vorhanden.
NTMS_READY	Dieses Gerät oder Objekt ist verfügbar und bereit.
NTMS_NEEDS_SERVICE	Dieses Gerät oder Objekt ist fehlgeschlagen und benötigt Dienst.

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 von Geräte- und Systemsteuerungsobjekten kann mithilfe der SetNtmsObjectInformation-Funktion geändert werden. (Schreibbar für alle Objekte)

Info

Objektspezifische Informationen zu Geräte- oder Systemsteuerelementen. Das Format dieser Informationen hängt vom dwType Member ab.

Info.Drive

Typ: NTMS_DRIVEINFORMATION Dieses Format wird verwendet, wenn der wert dwTypeNTMS_DRIVEist.

Info.DriveType

Typ: NTMS_DRIVETYPEINFORMATION Dieses Format wird verwendet, wenn der wert dwTypeNTMS_DRIVE_TYPEist.

Info.Library

Typ: NTMS_LIBRARYINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_LIBRARYist.

Info.Changer

Typ: NTMS_CHANGERINFORMATION Dieses Format wird verwendet, wenn der wert dwTypeNTMS_CHANGERist.

Info.ChangerType

Typ: NTMS_CHANGERTYPEINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_CHANGER_TYPEist.

Info.StorageSlot

Typ: NTMS_STORAGESLOTINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_STORAGESLOTist.

Info.IEDoor

Typ: NTMS_IEDOORINFORMATION Dieses Format wird verwendet, wenn der wert dwTypeNTMS_IEDOORist.

Info.IEPort

Typ: NTMS_IEPORTINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_IEPORTist.

Info.PhysicalMedia

Typ: NTMS_PMIDINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_PHYSICAL_MEDIAist.

Info.LogicalMedia

Typ: NTMS_LMIDINFORMATION Dieses Format wird verwendet, wenn der wert dwTypeNTMS_LOGICAL_MEDIAist.

Info.Partition

Typ: NTMS_PARTITIONINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_PARTITIONist.

Info.MediaPool

Typ: NTMS_MEDIAPOOLINFORMATION Dieses Format wird verwendet, wenn der wert dwTypeNTMS_MEDIA_POOList.

Info.MediaType

Typ: NTMS_MEDIATYPEINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_MEDIA_TYPEist.

Info.LibRequest

Typ: NTMS_LIBREQUESTINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_LIBREQUESTist.

Info.OpRequest

Typ: NTMS_OPREQUESTINFORMATION Dieses Format wird verwendet, wenn der dwType Wert NTMS_OPREQUESTist.

Info.Computer

Bemerkungen

Alle Member der NTMS_OBJECTINFORMATION-Struktur sind schreibgeschützt auf der RSM-Funktionsebene, es sei denn, sie sind in der Definition des Elements als schreibgeschützt angegeben.

Anmerkung

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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	ntmsapi.h

Siehe auch

GetNtmsObjectInformation-

SetNtmsObjectInformation-

Freigeben über

NTMS_OBJECTINFORMATIONA Struktur (ntmsapi.h)

Syntax

Angehörige

Bemerkungen

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen