NTMS_OBJECTINFORMATIONW Struktur (ntmsapi.h)

[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_OBJECTINFORMATIONW {
  DWORD      dwSize;
  DWORD      dwType;
  SYSTEMTIME Created;
  SYSTEMTIME Modified;
  NTMS_GUID  ObjectGuid;
  BOOL       Enabled;
  DWORD      dwOperationalState;
  WCHAR      szName[NTMS_OBJECTNAME_LENGTH];
  WCHAR      szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
  union {
    NTMS_DRIVEINFORMATIONW       Drive;
    NTMS_DRIVETYPEINFORMATIONW   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONW     Changer;
    NTMS_CHANGERTYPEINFORMATIONW ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONW        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONW   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONW  LibRequest;
    NTMS_OPREQUESTINFORMATIONW   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#else
  union {
    NTMS_DRIVEINFORMATIONW       Drive;
    NTMS_DRIVETYPEINFORMATIONW   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONW     Changer;
    NTMS_CHANGERTYPEINFORMATIONW ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONW        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONW   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONW  LibRequest;
    NTMS_OPREQUESTINFORMATIONW   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#endif
} NTMS_OBJECTINFORMATIONW, *LPNTMS_OBJECTINFORMATIONW;

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.

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:

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

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.

Anforderungen

Siehe auch

GetNtmsObjectInformation-

SetNtmsObjectInformation-