struktur NTMS_LIBRARYINFORMATION (ntmsapi.h)

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

Struktur NTMS_LIBRARYINFORMATION menentukan properti khusus untuk objek pustaka.

Sintaks

typedef struct _NTMS_LIBRARYINFORMATION {
  DWORD     LibraryType;
  NTMS_GUID CleanerSlot;
  NTMS_GUID CleanerSlotDefault;
  BOOL      LibrarySupportsDriveCleaning;
  BOOL      BarCodeReaderInstalled;
  DWORD     InventoryMethod;
  DWORD     dwCleanerUsesRemaining;
  DWORD     FirstDriveNumber;
  DWORD     dwNumberOfDrives;
  DWORD     FirstSlotNumber;
  DWORD     dwNumberOfSlots;
  DWORD     FirstDoorNumber;
  DWORD     dwNumberOfDoors;
  DWORD     FirstPortNumber;
  DWORD     dwNumberOfPorts;
  DWORD     FirstChangerNumber;
  DWORD     dwNumberOfChangers;
  DWORD     dwNumberOfMedia;
  DWORD     dwNumberOfMediaTypes;
  DWORD     dwNumberOfLibRequests;
  GUID      Reserved;
  BOOL      AutoRecovery;
  DWORD     dwFlags;
} NTMS_LIBRARYINFORMATION;

Anggota

LibraryType

Objek jenis pustaka. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
NTMS_LIBRARYTYPE_ONLINE	Elemen robotik yang mengotomatiskan pemasangan dan melepas media menjadi satu atau beberapa drive.
NTMS_LIBRARYTYPE_STANDALONE	Drive mandiri yang dimodelkan sebagai pustaka dengan satu drive di RSM.
NTMS_LIBRARYTYPE_OFFLINE	Media yang tidak ada dalam pustaka ada di pustaka luring.
NTMS_LIBRARYTYPE_UNKNOWN	Tipe pustaka tidak dapat ditentukan.

CleanerSlot

Untuk setiap pustaka, ini mewakili slot yang ditetapkan ke kartrid pembersih. Jika anggota ini NULL, tidak ada slot yang lebih bersih yang ditentukan untuk pustaka ini.

CleanerSlotDefault

Mewakili slot pembersih default atau pilihan pustaka. Jika NULL, tidak ada slot pilihan.

LibrarySupportsDriveCleaning

Digunakan oleh drive yang memerlukan pembersihan di bawah kontrol robotik. Jika TRUE, operasi pembersihan drive otomatis diaktifkan.

BarCodeReaderInstalled

Mengembalikan TRUE jika pembaca kode batang diinstal di pustaka; jika tidak, mengembalikan FALSE.

InventoryMethod

Metode default atau yang dipilih pengguna untuk melakukan inventarsi pustaka ini. (Anggota ini bisa ditulis.) Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
NTMS_INVENTORY_FAST	Jika pustaka memiliki pembaca kode batang yang terinstal, nilai ini menyebabkan inventori kode batang dilakukan. Jika pustaka tidak memiliki pembaca kode batang, bendera ini menyebabkan inventori diferensial dilakukan (slot yang beralih dari kosong ke penuh diklasifikasikan).
NTMS_INVENTORY_OMID	Inventori lengkap melibatkan pemasangan setiap sisi di pustaka dan membaca identifikasi di media dari media. Jenis inventori ini bisa sangat memakan waktu untuk beberapa unit pustaka.
NTMS_INVENTORY_NONE	Setelah pintu perpustakaan ditutup, tidak ada inventori yang dilakukan. Inventori mungkin diperlukan jika pemeriksaan label pemasangan gagal.

dwCleanerUsesRemaining

Jumlah penggunaan yang tersisa pada pembersih di pustaka. Anggota ini nol jika tidak ada pembersih atau jika pustaka tidak mendukung pembersihan.

FirstDriveNumber

Jumlah drive pertama di pustaka.

dwNumberOfDrives

Jumlah drive di pustaka.

FirstSlotNumber

Jumlah slot pertama di pustaka.

dwNumberOfSlots

Jumlah slot di pustaka.

FirstDoorNumber

Jumlah pintu akses pertama di pustaka.

dwNumberOfDoors

Jumlah pintu akses di pustaka.

FirstPortNumber

Jumlah port insert/eject pertama di pustaka.

dwNumberOfPorts

Jumlah port sisipkan/keluarkan di pustaka.

FirstChangerNumber

Jumlah pengubah pertama di pustaka.

dwNumberOfChangers

Jumlah pengubah di pustaka.

dwNumberOfMedia

Jumlah media dalam pustaka online atau offline.

dwNumberOfMediaTypes

Jumlah tipe media yang didukung oleh pustaka.

dwNumberOfLibRequests

Jumlah permintaan pustaka saat ini.

Reserved

Dicadangkan.

AutoRecovery

Jika anggota ini TRUE, inventori lengkap akan dilakukan jika pemasangan gagal. Kegagalan mungkin perangkat keras atau label tidak cocok. Untuk pustaka ATAPI CD, parameter ini tidak dapat dinonaktifkan. Defaultnya adalah TRUE. Pemilik pustaka besar harus menonaktifkan fitur ini.

dwFlags

Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
NTMS_LIBRARYFLAG_FIXEDOFFLINE	Pustaka adalah pustaka offline, bukan pustaka yang tidak ada.
NTMS_LIBRARYFLAG_CLEANERPRESENT	Pembersih ada di pengubah.
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING	Kartrid pembersih akan digunakan sampai tidak lagi membersihkan drive, alih-alih melacak jumlah pembersihan yang tersisa. Jangan atur bendera ini secara langsung. Ini diatur atau dibersihkan berdasarkan nilai dwCleanerUsesRemaining. Ini diatur jika dwCleanerUsesRemaining 0xFFFFFFFF, dan dibersihkan sebaliknya.
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE	Perlakukan kartrid barcoded yang memiliki CLN sebagai awalan sebagai kartrid yang lebih bersih, alih-alih memasangnya di drive untuk mengidentifikasinya.

Keterangan

Untuk pustaka offline, hanya LibraryType dan dwNumberOfMedia yang dilaporkan. Semua nilai lain harus diabaikan.

Struktur NTMS_LIBRARYINFORMATION disertakan dalam struktur NTMS_OBJECTINFORMATION .

Persyaratan

Persyaratan	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

NTMS_OBJECTINFORMATION