Fungsi WaitForNtmsOperatorRequest (ntmsapi.h)

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

Fungsi WaitForNtmsOperatorRequest menunggu permintaan operator RSM yang ditentukan.

Sintaks

DWORD WaitForNtmsOperatorRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwTimeout
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpRequestId

Pengidentifikasi permintaan operator yang dibuat oleh fungsi SubmitNtmsOperatorRequest .

[in] dwTimeout

Jumlah milidetik untuk menunggu. Untuk memeriksa permintaan operator, berikan nilai batas waktu nol. Jika Anda menentukan nilai INFINITE, fungsi ini tidak kehabisan waktu.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_CANCELLED	Permintaan operator dibatalkan oleh administrator.
ERROR_INVALID_HANDLE	Nilai yang ditentukan dalam parameter hSession adalah 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 permintaan operator. Permintaan objek dibersihkan dari database. Aplikasi harus memanggil fungsi seperti AllocateNtmsMedia jika RSM mengembalikan kesalahan ini.
ERROR_SUCCESS	Fungsi berhasil.
ERROR_TIMEOUT	Waktu yang ditentukan dalam parameter dwTimeout berlalu sebelum penyelesaian permintaan operator.

Keterangan

Permintaan operator yang ditentukan dengan fungsi WaitForNtmsOperatorRequest digunakan untuk meminta media, untuk meminta agar media dipindahkan dari satu pustaka ke pustaka lain, atau untuk meminta layanan perangkat RSM.

Aplikasi menggunakan WaitForNtmsOperatorRequest untuk menunggu resolusi permintaan operator. Permintaan dapat dipenuhi, ditolak, dihapus, atau kehabisan waktu.

Biasanya, aplikasi menggunakan fungsi SubmitNtmsOperatorRequest untuk mengirimkan permintaan operator dan menggunakan fungsi WaitForNtmsOperatorRequest untuk menunggu resolusinya.

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

CancelNtmsOperatorRequest

Fungsi Permintaan Operator

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest