Fungsi AccessNtmsLibraryDoor (ntmsapi.h)

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

Fungsi AccessNtmsLibraryDoor membuka kunci pintu pustaka yang ditentukan. Jika pustaka sibuk, RSM mengantrekan permintaan dan berhasil dikembalikan.

Sintaks

DWORD AccessNtmsLibraryDoor(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpLibraryId

Pengidentifikasi unik objek pustaka. Pustaka ini harus mendukung akses pintu.

[in] dwAction

Tindakan yang harus dilakukan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
NTMS_INVENTORY_NONE	Setelah pengguna menutup pintu, tidak ada inventori yang dilakukan. Namun, jika pemeriksaan label pemasangan gagal, inventori akan dilakukan.
NTMS_INVENTORY_OMID	Setelah pengguna menutup pintu, inventori on-media penuh dilakukan. Ini bisa memakan waktu karena setiap sisi dari setiap media harus dipasang.
NTMS_INVENTORY_FAST	Jika pustaka memiliki pembaca kode batang yang terinstal, bendera ini menyebabkan inventori kode batang dilakukan. Jika pustaka tidak memiliki pembaca kode batang, bendera ini menyebabkan inventori diferensial dilakukan. OMID diperiksa pada setiap medium yang ditempatkan di slot kosong saat pintu terbuka.
NTMS_INVENTORY_DEFAULT	Gunakan InventoryMethod yang ditentukan dalam objek pustaka (lihat NTMS_LIBRARYINFORMATION).

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS ke pustaka ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan.
ERROR_DATABASE_FAILURE	Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL	Database penuh.
ERROR_INVALID_HANDLE	ID sesi hilang atau tidak valid.
ERROR_INVALID_PARAMETER	ID pustaka hilang.
ERROR_LIBRARY_OFFLINE	ID pustaka mereferensikan pustaka offline tanpa pintu.
ERROR_NOT_ENOUGH_MEMORY	Kegagalan alokasi terjadi selama pemrosesan.
ERROR_RESOURCE_DISABLED	Pustaka dinonaktifkan.
ERROR_RESOURCE_NOT_PRESENT	Pustaka tidak memiliki pintu.
ERROR_SUCCESS	Akses pintu diantrekan.

Keterangan

Beberapa pustaka tidak menyediakan sarana bagi RSM untuk mengunci dan membuka kunci pintu secara terprogram. Perilaku fungsi ini dengan pustaka ini identik dengan perilakunya dengan pustaka yang dapat dibuka dan dikunci RSM.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	ntmsapi.h
Pustaka	Ntmsapi.lib
DLL	Ntmsapi.dll

Lihat juga

EjectNtmsMedia

InjectNtmsMedia

Fungsi Kontrol Pustaka