Fungsi MountNtmsMedia (ntmsapi.h)

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

Fungsi MountNtmsMedia secara sinkron memasang satu atau beberapa bagian media.

Sintaks

DWORD MountNtmsMedia(
  [in]      HANDLE                   hSession,
  [in]      LPNTMS_GUID              lpMediaId,
  [in, out] LPNTMS_GUID              lpDriveId,
  [in]      DWORD                    dwCount,
  [in]      DWORD                    dwOptions,
  [in]      int                      dwPriority,
  [in]      DWORD                    dwTimeout,
            LPNTMS_MOUNT_INFORMATION lpMountInformation
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpMediaId

Array pengidentifikasi unik media atau sisi logis.

[in, out] lpDriveId

Array pengidentifikasi drive yang sesuai dengan daftar media dalam parameter lpMediaId . Array ini menentukan daftar drive untuk memasang media ke dalam atau menerima daftar drive yang dipasang media pada penyelesaian operasi. Lihat nilai NTMS_MOUNT_SPECIFIC_DRIVE di bawah ini. Jika waktu fungsi MountNtmsMedia habis sebelum penyelesaian pemasangan, RSM tidak mengembalikan daftar drive.

[in] dwCount

Jumlah pengidentifikasi media dan pengidentifikasi drive yang diteruskan dalam parameter lpMediaId dan lpDriveId . Perhatikan bahwa lpMediaId dan lpDriveId harus menunjuk ke elemen pertama array dengan panjang yang sama.

[in] dwOptions

Opsi. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai Makna
NTMS_MOUNT_SPECIFIC_DRIVE
 Pasang media ke dalam drive tertentu yang disediakan dalam parameter lpDriveId .
NTMS_MOUNT_READ
 Pasang media untuk akses baca. Gunakan nilai ini untuk memasang media baca-saja.
NTMS_MOUNT_WRITE
 Pasang media untuk akses tulis. Gunakan bendera ini untuk mencegah RSM memasang media selesai. Nilai ini dapat dikombinasikan dengan NTMS_MOUNT_READ untuk akses baca/tulis.

RSM tidak dapat memasang media Selesai jika bendera ini dipilih.
NTMS_MOUNT_ERROR_NOT_AVAILABLE
 Nilai ini mengembalikan kesalahan jika media atau drive tidak tersedia.
NTMS_MOUNT_ERROR_OFFLINE
 Jangan terbitkan permintaan operator untuk memasang media offline. Mengembalikan kesalahan jika media yang ditentukan saat ini tidak berada dalam pustaka.

[in] dwPriority

Prioritas pemasangan yang digunakan oleh RSM untuk memungkinkan akses ke drive. Prioritas berkisar dari -15 hingga 15, dengan 15 prioritas tertinggi dan 0 adalah default. Parameter ini juga dapat mengambil salah satu konstanta berikut. Aplikasi harus melewati NTMS_PRIORITY_NORMAL kecuali diperlukan prioritas pemasangan khusus.

Nilai Makna
NTMS_PRIORITY_NORMAL
 Pemasangan yang tidak kritis waktu.
NTMS_PRIORITY_LOW
 Pemasangan dilakukan sebagai aktivitas latar belakang.
NTMS_PRIORITY_HIGH
 Dudukan yang kritis waktu.
NTMS_PRIORITY_LOWEST
 Pemasangan prioritas terendah.
NTMS_PRIORITY_HIGHEST
 Pemasangan prioritas tertinggi.

[in] dwTimeout

Waktu maksimum yang diizinkan untuk memasang media yang ditentukan, dalam milidetik. Atur parameter ini ke INFINITE untuk menunggu hingga pemasangan selesai.

lpMountInformation

Parameter ini dicadangkan dan harus NULL.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai Makna
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS ke kumpulan media atau pustaka yang berisi media ditolak; kesalahan keamanan lainnya juga dimungkinkan tetapi akan menunjukkan kesalahan subsistem keamanan.
ERROR_BUSY
 Media atau drive sibuk.
ERROR_CANCELLED
 Permintaan dibatalkan oleh fungsi CloseNtmsSession .
ERROR_DATABASE_FAILURE
 Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL
 Database penuh.
ERROR_DRIVE_MEDIA_MISMATCH
 Media dan drive yang ditentukan tidak berada dalam pustaka yang sama.
ERROR_INVALID_DRIVE
 Setidaknya salah satu drive yang ditentukan tidak valid.
ERROR_INVALID_LIBRARY
 Pustaka yang memuat kandar atau media tidak valid.
ERROR_INVALID_MEDIA
 Satu atau beberapa media yang ditentukan tidak valid, atau ada ID media duplikat dalam daftar media.
ERROR_INVALID_STATE
 Terjadi media atau status perangkat yang tidak terduga selama pemasangan.
ERROR_MEDIA_OFFLINE
 Media offline dan tidak dapat dipasang.
ERROR_NOT_ENOUGH_MEMORY
 Kegagalan alokasi memori terjadi selama pemrosesan.
ERROR_REQUEST_REFUSED
 Pengguna membatalkan permintaan melalui antarmuka pengguna.
ERROR_RESOURCE_DISABLED
 Satu atau beberapa sumber daya yang diperlukan untuk melakukan pemasangan dinonaktifkan.
ERROR_SUCCESS
 Media telah dipasang dan siap digunakan.
ERROR_TIMEOUT
 Peristiwa waktu habis kedaluwarsa saat mencoba memperoleh satu atau beberapa sumber daya yang diperlukan. Permintaan pemasangan telah dibatalkan.
ERROR_WRITE_PROTECT
 Status media diatur ke Selesai dan nilai NTMS_MOUNT_WRITE ditentukan.

Keterangan

Fungsi MountNtmsMedia mengantrekan permintaan untuk memasang media yang ditentukan, lalu menunggu jumlah milidetik yang ditentukan dalam parameter dwTimeout agar pemasangan selesai atau kesalahan terdeteksi. Jika RSM tidak dapat menyelesaikan operasi pemasangan sebelum dwTimeout kedaluwarsa, NTMS membatalkan permintaan dan mengembalikan kesalahan. Jika media yang ditentukan berada di pustaka offline, aplikasi mungkin diblokir untuk jangka waktu yang lama. Anda dapat menggunakan fungsi GetNtmsObjectInformation untuk menentukan lokasi media yang ditentukan saat ini. Anda juga dapat menggunakan nilai NTMS_MOUNT_ERROR_OFFLINE untuk menghasilkan kesalahan langsung alih-alih permintaan operator saat media offline.

Jika media yang ditentukan sedang digunakan atau drive tidak tersedia, proses memblokir hingga nilai batas waktu dan mengembalikan ERROR_BUSY. Jika nilai NTMS_MOUNT_ERROR_NOT_AVAILABLE ditentukan, fungsi mengembalikan kesalahan langsung saat sumber daya (media atau drive) tidak tersedia.

Nilai batas waktu INFINITE dapat digunakan untuk membuat fungsi menunggu tanpa waktu habis. Ketika nilai batas waktu non-nol ditentukan dalam parameter dwTimeout , RSM menunggu semua media yang ditentukan dalam lpMediaId untuk dipasang. Jika waktu yang ditentukan berlalu sebelum semua media dipasang, fungsi MountNtmsMedia mengembalikan kesalahan dan membatalkan permintaan. Aplikasi dapat memeriksa status yang dikembalikan dan mengirimkan ulang permintaan jika diinginkan.

Ketika beberapa media yang akan dipasang ditentukan dengan satu panggilan, semua media yang ditentukan harus berada dalam satu pustaka. Jika salah satu media yang ditentukan offline, tidak ada media yang akan dipasang sampai semua media online.

Pada penyelesaian pemasangan, status drive (misalnya, mode perbaikan atau variabel) tidak ditentukan. Aplikasi harus menyiapkan drive.

Fungsi CloseNtmsSession dapat digunakan untuk membatalkan pemasangan yang tertunda. Perilaku defaultnya adalah:

  • Jika media yang ditentukan offline, RSM memposting permintaan operator untuk memasang media dan fungsi MountNtmsMedia menunggu periode waktu yang ditentukan dalam parameter dwTimeout .
  • Jika media yang ditentukan online, RSM meminta pemasangan.
  • Jika drive atau media tidak tersedia, RSM mengirimkan permintaan dan fungsi MountNtmsMedia menunggu periode waktu yang ditentukan dalam parameter dwTimeout .

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

Fungsi Media Services

  • Last updated on