struktur NTMS_OBJECTINFORMATIONA (ntmsapi.h)

[ Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]

Struktur NTMS_OBJECTINFORMATION menentukan properti yang dapat didapatkan dan diatur aplikasi untuk perangkat RSM, media, dan kontrol sistem (seperti pustaka, drive, media, permintaan operator). Ini adalah struktur umum objek dalam database RSM.

Sintaksis

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;

Anggota

dwSize

Jenis: DWORD

Ukuran struktur informasi, dalam byte. Anggota ini harus diatur ke ukuran struktur yang benar sebelum menggunakan fungsi GetNtmsObjectInformation atau fungsi SetNtmsObjectInformation .

dwType

Jenis: DWORD

Jenis kontrol perangkat atau sistem untuk mendapatkan/mengatur informasi. Anggota ini harus diatur ke salah satu nilai berikut.

Nilai	Arti
NTMS_CHANGER	Objek pengubah mewakili elemen robot dari unit pustaka. Anggota Info adalah penunjuk ke struktur NTMS_CHANGERINFORMATION.
NTMS_CHANGER_TYPE	Objek jenis pengubah dibuat untuk setiap jenis perangkat pengubah unik yang dilampirkan ke sistem. Anggota Info adalah penunjuk ke struktur NTMS_CHANGERTYPEINFORMATION.
NTMS_COMPUTER	Objek komputer saat ini. Tidak ada struktur untuk objek komputer. Anggota Info adalah penunjuk ke struktur NTMS_COMPUTERINFORMATION.
NTMS_DRIVE	Objek drive mewakili kandar pita atau drive disk. Anggota Info adalah penunjuk ke struktur NTMS_DRIVEINFORMATION.
NTMS_DRIVE_TYPE	Objek jenis drive dibuat untuk setiap jenis perangkat drive unik yang terpasang pada sistem. Anggota Info adalah penunjuk ke struktur NTMS_DRIVETYPEINFORMATION.
NTMS_IEDOOR	Objek NTMS_IEDOOR mewakili mekanisme akses pintu unit pustaka. Anggota Info adalah penunjuk ke struktur NTMS_IEDOORINFORMATION.
NTMS_IEPORT	Objek NTMS_IEPORT mewakili port insert/eject unit pustaka. Anggota Info adalah penunjuk ke struktur NTMS_IEPORTINFORMATION.
NTMS_LIBRARY	Objek pustaka mewakili pustaka online atau offline. Anggota Info adalah penunjuk ke struktur NTMS_LIBRARYINFORMATION.
NTMS_LIBREQUEST	Objek permintaan pustaka dibuat untuk setiap permintaan pustaka untuk melakukan tindakan. Daftar permintaan pustaka dikelola oleh RSM sebagai antrean pekerjaan yang akan dilakukan. Anggota Info adalah penunjuk ke struktur NTMS_LIBREQUESTINFORMATION.
NTMS_LOGICAL_MEDIA	Handel utama yang digunakan oleh aplikasi untuk mengakses media yang ditentukan. Dalam kasus media multi-sisi, setiap sisi diperlakukan sebagai bagian individu dari media fisik. Anggota Info adalah penunjuk ke struktur NTMS_LMIDINFORMATION.
NTMS_MEDIA_POOL	Kumpulan media adalah pengelompokan media yang logis. Semua media dalam kumpulan media harus berjenis media yang sama. Anggota Info adalah penunjuk ke struktur NTMS_MEDIAPOOLINFORMATION.
NTMS_MEDIA_TYPE	Objek jenis media dibuat untuk setiap jenis media unik dalam sistem. Anggota Info adalah penunjuk ke struktur NTMS_MEDIATYPEINFORMATION.
NTMS_OPREQUEST	Objek permintaan operator mewakili permintaan RSM bagi pengguna untuk mendapatkan informasi. Anggota Info adalah penunjuk ke struktur NTMS_OPREQUESTINFORMATION.
NTMS_PARTITION	Objek samping mewakili sisi sepotong media fisik. Anggota Info adalah penunjuk ke struktur NTMS_PARTITIONINFORMATION.
NTMS_PHYSICAL_MEDIA	Objek media fisik mewakili pita magnetik atau disk yang dapat dilepas. Sepotong media fisik dapat berisi satu atau beberapa sisi. Anggota Info adalah penunjuk ke struktur NTMS_PMIDINFORMATION.
NTMS_STORAGESLOT	Objek slot penyimpanan mewakili salah satu slot yang dapat menyimpan media yang ditentukan dalam pustaka. Anggota Info adalah penunjuk ke struktur NTMS_STORAGESLOTINFORMATION.

Created

Jenis: SYSTEMTIME

Stempel tanggal/waktu saat objek dibuat.

Modified

Jenis: SYSTEMTIME

Stempel tanggal/waktu saat objek dimodifikasi.

ObjectGuid

Jenis: NTMS_GUID

GUID objek.

Enabled

Jenis: BOOL

Menunjukkan apakah perangkat atau objek kontrol sistem diaktifkan.

dwOperationalState

Jenis: DWORD

Menentukan status operasional objek saat ini. Ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
NTMS_NOT_PRESENT	Perangkat atau objek ini saat ini tidak ada.
NTMS_READY	Perangkat atau objek ini tersedia dan siap.
NTMS_NEEDS_SERVICE	Perangkat atau objek ini gagal dan membutuhkan layanan.

szName[NTMS_OBJECTNAME_LENGTH]

Jenis: TCHAR[NTMS_OBJECTNAME_LENGTH]

Nama media, perangkat, atau objek kontrol sistem. Kumpulan media dan nama media logis dapat diubah menggunakan fungsi SetNtmsObjectInformation. Semua nama objek lainnya bersifat baca-saja.

szDescription[NTMS_DESCRIPTION_LENGTH]

Jenis: TCHAR[NTMS_DESCRIPTION_LENGTH]

Deskripsi perangkat atau objek kontrol sistem. Deskripsi objek kontrol perangkat dan sistem dapat diubah menggunakan fungsi SetNtmsObjectInformation. (Bisa-tulis untuk semua objek)

Info

Informasi khusus objek kontrol perangkat atau sistem. Format informasi ini tergantung pada anggota dwType.

Info.Drive

Jenis: NTMS_DRIVEINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_DRIVE.

Info.DriveType

Jenis: NTMS_DRIVETYPEINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_DRIVE_TYPE.

Info.Library

Jenis: NTMS_LIBRARYINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_LIBRARY.

Info.Changer

Jenis: NTMS_CHANGERINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_CHANGER.

Info.ChangerType

Jenis: NTMS_CHANGERTYPEINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_CHANGER_TYPE.

Info.StorageSlot

Jenis: NTMS_STORAGESLOTINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_STORAGESLOT.

Info.IEDoor

Jenis: NTMS_IEDOORINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_IEDOOR.

Info.IEPort

Jenis: NTMS_IEPORTINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_IEPORT.

Info.PhysicalMedia

Jenis: NTMS_PMIDINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_PHYSICAL_MEDIA.

Info.LogicalMedia

Jenis: NTMS_LMIDINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_LOGICAL_MEDIA.

Info.Partition

Jenis: NTMS_PARTITIONINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_PARTITION.

Info.MediaPool

Jenis: NTMS_MEDIAPOOLINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_MEDIA_POOL.

Info.MediaType

Jenis: NTMS_MEDIATYPEINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_MEDIA_TYPE.

Info.LibRequest

Jenis: NTMS_LIBREQUESTINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_LIBREQUEST.

Info.OpRequest

Jenis: NTMS_OPREQUESTINFORMATION

Format ini digunakan jika nilai dwTypeNTMS_OPREQUEST.

Info.Computer

Komentar

Semua anggota struktur NTMS_OBJECTINFORMATION bersifat baca-saja di tingkat fungsi RSM kecuali ditentukan sebagai WRITABLE dalam definisi anggota.

Nota

Header ntmsapi.h mendefinisikan NTMS_OBJECTINFORMATION sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	ntmsapi.h

Lihat juga

GetNtmsObjectInformation

SetNtmsObjectInformation