Fungsi CleanNtmsDrive (ntmsapi.h)

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

Fungsi CleanNtmsDrive mengantrekan permintaan pembersihan untuk drive yang ditentukan untuk dibersihkan.

Sintaks

DWORD CleanNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpDriveId

Pengidentifikasi unik drive yang akan dibersihkan.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS ke pustaka 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_DRIVE	ID drive tidak valid.
ERROR_INVALID_HANDLE	Handel sesi hilang atau tidak valid.
ERROR_INVALID_LIBRARY	Pustaka untuk kandar tidak valid.
ERROR_INVALID_PARAMETER	ID drive hilang.
ERROR_NOT_ENOUGH_MEMORY	Kegagalan alokasi terjadi selama pemrosesan.
ERROR_RESOURCE_DISABLED	Kandar atau pustaka tidak diaktifkan.
ERROR_SUCCESS	Pembersihan berhasil diantrekan.

Keterangan

Jika drive yang Anda pilih dalam fungsi CleanNtmsDrive adalah drive yang berdiri sendiri, drive ditandai sebagai dibersihkan dan waktu dicatat dalam Database RSM.

Permintaan pembersihan antrean dihapus saat layanan dimulai ulang.

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 Manajemen Pembersih

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot

ReserveNtmsCleanerSlot