Fungsi SubmitNtmsOperatorRequestA (ntmsapi.h)

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

Fungsi SubmitNtmsOperatorRequest mengirimkan permintaan operator RSM.

Sintaksis

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession.

[in] dwRequest

Jenis permintaan operator. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
NTMS_OPREQ_CLEANER	RSM mengirimkan permintaan operator untuk menyisipkan pembersih saat operasi bersih diantrekan dan tidak ada pembersih yang tersedia untuk drive. Parameter lpArg1Id dapat berupa pustaka atau pengidentifikasi slot. Memerlukan NTMS_CONTROL_ACCESS ke pustaka. Windows XP: Tidak diperlukan hak akses.
NTMS_OPREQ_DEVICESERVICE	Aplikasi atau RSM mengirimkan permintaan operator untuk layanan drive saat perangkat atau drive pengubah mengalami masalah. Parameter lpArg1Id menentukan perangkat yang membutuhkan layanan. Parameter ini dapat menjadi pengidentifikasi iedoor, pustaka, media fisik, atau drive. Memerlukan NTMS_CONTROL_ACCESS ke pustaka. Windows XP: Tidak diperlukan hak akses.
NTMS_OPREQ_MESSAGE	Hanya pesan aplikasi. Memerlukan NTMS_USE_ACCESS ke komputer. Windows XP: Tidak diperlukan hak akses.
NTMS_OPREQ_MOVEMEDIA	Aplikasi atau RSM mengirimkan permintaan operator untuk memindahkan media dari satu pustaka ke pustaka lain untuk pemasangan media offline atau mengeluarkan media yang ada ke pustaka offline. Parameter lpArg1Id menentukan bagian media fisik yang harus dipindahkan dan parameter lpArg2Id menentukan pustaka target. Memerlukan NTMS_CONTROL_ACCESS ke kumpulan media. Windows XP: Tidak diperlukan hak akses.
NTMS_OPREQ_NEWMEDIA	Aplikasi atau RSM mengirimkan permintaan operator untuk media baru ketika tidak ada media yang tersedia. Parameter lpArg1Id menentukan objek kumpulan media dan parameter lpArg2Id adalah pengidentifikasi pustaka opsional untuk menambahkan media baru. Memerlukan NTMS_CONTROL_ACCESS ke kumpulan media. Windows XP: Tidak diperlukan hak akses.

[in] lpMessage

String pesan opsional yang akan dikirim ke pengguna.

[in] lpArg1Id

Pengidentifikasi objek untuk permintaan operator. Lihat deskripsi nilai dalam parameter dwRequest untuk deskripsi jenis objek apa yang harus diteruskan untuk parameter ini.

[in] lpArg2Id

Pengidentifikasi objek untuk permintaan operator. Lihat deskripsi nilai dalam parameter dwRequest untuk detail tentang jenis objek apa yang harus diteruskan untuk parameter ini.

[out] lpRequestId

Penunjuk ke buffer yang menerima pengidentifikasi permintaan operator yang dibuat.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Arti
ERROR_ACCESS_DENIED	Akses ke satu atau beberapa objek RSM ditolak.
ERROR_DATABASE_FAILURE	Kueri atau pembaruan database gagal.
ERROR_INVALID_HANDLE	Nilai yang ditentukan dalam parameter hSession null atau tidak valid.
ERROR_INVALID_PARAMETER	Salah satu nilai parameter tidak valid.
ERROR_NOT_CONNECTED	Tidak dapat tersambung ke layanan RSM.
ERROR_OBJECT_NOT_FOUND	Tidak dapat menemukan objek sumber atau tujuan.
ERROR_SUCCESS	Fungsi berhasil.

Komentar

Fungsi SubmitNtmsOperatorRequest mengirimkan permintaan operator dan mengembalikan status permintaan (Puas atau Dibatalkan) atau waktu habis (jika operator tidak bertindak berdasarkan permintaan). Permintaan operator digunakan untuk meminta media, untuk meminta agar media yang ditentukan dipindahkan dari satu pustaka ke pustaka lain, atau untuk meminta layanan perangkat RSM.

Nilai NTMS_OPEREQ_MESSAGE (dalam parameter dwRequest) adalah jenis permintaan yang paling sering digunakan oleh aplikasi. RSM tidak dapat menggunakan NTMS_OPEREQ_MESSAGE. RSM menggunakan jenis permintaan lainnya sesuai kebutuhan.

Nota

Header ntmsapi.h mendefinisikan SubmitNtmsOperatorRequest sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor 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]
Platform Target	Windows
Header	ntmsapi.h
Pustaka	Ntmsapi.lib
DLL	Ntmsapi.dll

Lihat juga

AllocateNtmsMedia

CancelNtmsOperatorRequest

MountNtmsMedia

Fungsi Permintaan Operator

SatisfyNtmsOperatorRequest

WaitForNtmsOperatorRequest