Fungsi SetNtmsRequestOrder (ntmsapi.h)

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

Fungsi SetNtmsRequestOrder mengatur urutan permintaan yang ditentukan akan diproses dalam antrean pustaka.

Sintaks

DWORD SetNtmsRequestOrder(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwOrderNumber
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpRequestId

Pengidentifikasi unik permintaan pustaka.

[in] dwOrderNumber

Pesan bahwa permintaan akan diproses dalam antrean.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS ke komputer ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan. Windows XP: Tidak diperlukan hak akses.
ERROR_DATABASE_FAILURE	Database tidak dapat diakses atau rusak.
ERROR_INVALID_HANDLE	Handel sesi hilang atau tidak valid.
ERROR_INVALID_PARAMETER	Pengidentifikasi permintaan pustaka hilang.
ERROR_OBJECT_NOT_FOUND	Objek permintaan dengan pengidentifikasi yang ditentukan tidak dapat ditemukan.
ERROR_SUCCESS	Fungsi berhasil.

Keterangan

Saat ini NTMS_LM_MOUNT permintaan diurutkan menggunakan nomor pesanan.

Nomor pesanan yang ditetapkan oleh fungsi SetNtmsRequestOrder khusus untuk jenis permintaan karena jenis diproses dalam urutan yang telah ditentukan. Misalnya, permintaan NTMS_LM_DISMOUNT diproses sebelum permintaan NTMS_LM_MOUNT. Namun, dalam kelas permintaan tertentu, antrean dapat dipesan. Permintaan yang diurutkan lebih rendah diproses terlebih dahulu; misalnya, 1 adalah permintaan pertama yang diproses, 2 adalah permintaan berikutnya yang diproses, dan sebagainya.

Untuk segera memproses permintaan, aplikasi dapat mengatur nomor pesanan ke 1. Untuk menungguhkan pemrosesan, aplikasi harus mengatur nomor pesanan ke jumlah yang sangat besar atau 0xFFFFFFFF. Nomor pesanan permintaan, yang saat ini memiliki jumlah pesanan nol, tidak dapat diubah.

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

GetNtmsRequestOrder

Fungsi Kontrol Pustaka