Fungsi GetNtmsRequestOrder (ntmsapi.h)

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

Fungsi GetNtmsRequestOrder mendapatkan urutan permintaan yang ditentukan akan diproses dalam antrean pustaka.

Sintaks

DWORD GetNtmsRequestOrder(
  [in]  HANDLE      hSession,
  [in]  LPNTMS_GUID lpRequestId,
  [out] LPDWORD     lpdwOrderNumber
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpRequestId

Pengidentifikasi unik permintaan pustaka.

[out] lpdwOrderNumber

Urutan di mana permintaan ini 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

Jika fungsi GetNtmsRequestOrder mengembalikan nol dalam lpdwOrderNumber, pengurutan tidak tersedia untuk permintaan ini. Nomor pesanan khusus untuk jenis permintaan karena jenisnya 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.

Anda dapat menggunakan nomor pesanan ini, jenis permintaan, waktu pengiriman, dan tanggal pengiriman untuk membantu melihat antrean dalam urutan yang diurutkan. Jenis permintaan, nomor pesanan, dan waktu pengiriman harus melakukan pengurutan.

Saat ini pada NTMS_LM_MOUNT, permintaan diurutkan menggunakan nomor pesanan.

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 Kontrol Pustaka

SetNtmsRequestOrder