Fungsi EjectDiskFromSADriveA (ntmsapi.h)

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

Fungsi EjectDiskFromSADrive mengeluarkan media yang berada dalam drive mandiri yang dapat dilepas.

Sintaks

DWORD EjectDiskFromSADriveA(
  [in] LPCSTR lpComputerName,
  [in] LPCSTR lpAppName,
  [in] LPCSTR lpDeviceName,
  [in] HWND   hWnd,
  [in] LPCSTR lpTitle,
  [in] LPCSTR lpMessage,
  [in] DWORD  dwOptions
);

Parameter

[in] lpComputerName

Nama server Manajer Penyimpanan (RSM) yang dapat dilepas. Jika parameter ini NULL, nama komputer saat ini akan digunakan.

[in] lpAppName

String karakter unik yang mengidentifikasi aplikasi. Nama ini mengidentifikasi sumber daya dan permintaan operator. Parameter ini bersifat opsional dan mungkin NULL.

[in] lpDeviceName

Nama perangkat yang akan dikeluarkan. Misalnya, \.\Cdrom0 atau \.\PhysicalDriveX (di mana X adalah jumlah drive yang diakses).

[in] hWnd

Menangani ke jendela kotak dialog untuk konfirmasi pengguna.

[in] lpTitle

Judul ditampilkan dalam kotak dialog untuk mendapatkan input pengguna.

[in] lpMessage

Pesan ditampilkan dalam kotak dialog untuk mendapatkan input pengguna.

[in] dwOptions

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

Nilai Makna
NTMS_EJECT_START
 Mulai operasi keluarkan dengan port. Media yang ditentukan dikeluarkan sampai peristiwa waktu habis terjadi atau fungsi dipanggil lagi dengan NTMS_EJECT_STOP. Nilai waktu habis ditentukan dalam objek pustaka dan diterapkan ke semua ejeksi di pustaka.
NTMS_EJECT_STOP
 Hentikan proses ejeksi sebelum peristiwa waktu habis berakhir.
NTMS_EJECT_QUEUE
 Izinkan eject menjadi asinkron. Fungsi mengantre media yang ditentukan untuk ejeksi lalu mengembalikan.
NTMS_EJECT_FORCE
 Paksa media dikeluarkan. Misalnya, NTFS dapat menahan kunci pada media, dan opsi ini akan menyebabkan media dikeluarkan meskipun kunci itu.
NTMS_EJECT_IMMEDIATE
 Keluarkan media segera dan sinkron. Fungsi tidak akan kembali sampai eject selesai. Tidak mengantre media yang ditentukan untuk ejeksi.
NTMS_EJECT_ASK_USER
 Keluarkan media segera dan sinkron. Fungsi tidak akan kembali sampai eject selesai. Tidak mengantre media yang ditentukan untuk ejeksi. Jika operasi keluarkan gagal, minta pengguna untuk membatalkan atau memaksa operasi.

Menampilkan nilai

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_DEVICE_NOT_AVAILABLE
 Pustaka dinonaktifkan.
ERROR_INVALID_HANDLE
 ID sesi hilang atau tidak valid.
ERROR_INVALID_OPERATION
 Penghentian dilakukan pada ID operasi yang tidak valid.
ERROR_INVALID_PARAMETER
 ID pustaka atau penunjuk ID operasi hilang.
ERROR_LIBRARY_OFFLINE
 ID pustaka mengacu pada pustaka offline yang tidak dapat mengeluarkan media.
ERROR_MEDIA_NOT_AVAILABLE
 Media dinonaktifkan.
ERROR_NOT_ENOUGH_MEMORY
 Terjadi kegagalan alokasi selama pemrosesan.
ERROR_SUCCESS
 Operasi keluar berhasil.

Keterangan

Meskipun EjectNtmsMedia dapat, dalam beberapa kasus, digunakan untuk mencapai fungsionalitas yang sama, EjectDiskFromSADrive menyediakan cara mudah untuk mengeluarkan media dari perangkat mandiri, dengan menentukan nama drive-nya alih-alih nama RSM-nya. Dalam beberapa kasus, ini adalah satu-satunya cara untuk mengatasi kunci sistem file pada media untuk mengeluarkan media tersebut.

Fungsi EjectDiskFromSADrive kembali ke aplikasi segera setelah permintaan keluar diantrekan, kecuali opsi NTMS_EJECT_IMMEDIATE ditentukan.

Media yang dikeluarkan menggunakan fungsi EjectDiskFromSADrive dipindahkan ke pustaka offline atau dihapus dari database. Impor media, media yang tidak dikenal, dan media yang tidak kompatibel akan dihapus saat dikeluarkan.

Fungsi EjectDiskFromSADrive tidak berfungsi dengan pustaka offline.

Catatan

Header ntmsapi.h mendefinisikan EjectDiskFromSADrive sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscessor 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

   
Klien minimum yang didukung Windows Vista [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

  • Last updated on