Fungsi DeleteNtmsRequests (ntmsapi.h)

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

Fungsi DeleteNtmsRequests menghapus permintaan atau daftar permintaan dari database RSM. Permintaan pustaka atau operator yang berada dalam status selesai, gagal, ditolak, atau dibatalkan dihapus. Permintaan yang dikirimkan, permintaan antrean, permintaan tunggu, dan permintaan yang sedang berlangsung tidak dapat dihapus.

Sintaks

DWORD DeleteNtmsRequests(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpRequestId

Daftar pengidentifikasi pustaka dan permintaan operator yang akan dihapus.

[in] dwType

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

Nilai Makna
NTMS_LIBREQUEST
Permintaan pustaka.
NTMS_OPREQUEST
Permintaan operator.

[in] dwCount

Jumlah permintaan dalam daftar.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai Makna
ERROR_ACCESS_DENIED
NTMS_MODIFY_ACCESS ke komputer ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan.

Windows XP: NTMS_CONTROL_ACCESS ke komputer ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan.

ERROR_DATABASE_FAILURE
Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL
Database penuh.
ERROR_INVALID_PARAMETER
Pengidentifikasi tipe tidak valid.
ERROR_INVALID_HANDLE
Handel sesi hilang atau tidak valid.
ERROR_NOT_ENOUGH_MEMORY
Kegagalan alokasi memori selama pemrosesan.
ERROR_SUCCESS
Fungsi berhasil dijalankan.

Keterangan

Kesalahan tidak dikembalikan jika permintaan atau daftar permintaan tidak ditemukan.

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