IEmptyVolumeCache::Initialize method (emptyvc.h)

Menginisialisasi handler pembersihan disk, berdasarkan informasi yang disimpan di bawah kunci registri yang ditentukan.

Sintaks

HRESULT Initialize(
  [in]      HKEY    hkRegKey,
  [in]      LPCWSTR pcwszVolume,
  [out]     LPWSTR  *ppwszDisplayName,
  [out]     LPWSTR  *ppwszDescription,
  [in, out] DWORD   *pdwFlags
);

Parameter

[in] hkRegKey

Jenis: HKEY

Handel ke kunci registri yang menyimpan informasi tentang objek handler.

[in] pcwszVolume

Jenis: LPCWSTR

Penunjuk ke string Unicode yang dihentikan null dengan akar volume—misalnya, "C:".

[out] ppwszDisplayName

Jenis: LPWSTR*

Penunjuk ke string Unicode yang dihentikan null dengan nama yang akan ditampilkan dalam daftar handler manajer pembersihan disk. Jika tidak ada nilai yang ditetapkan, nilai registri akan digunakan.

[out] ppwszDescription

Jenis: LPWSTR*

Penunjuk ke string Unicode yang dihentikan null yang akan ditampilkan ketika objek ini dipilih dari daftar handler pembersihan disk manajer pembersihan disk yang tersedia. Jika tidak ada nilai yang ditetapkan, nilai registri akan digunakan.

[in, out] pdwFlags

Jenis: DWORD*

Bendera yang digunakan untuk meneruskan informasi ke handler dan kembali ke manajer pembersihan disk.

Bendera ini dapat diteruskan ke objek :

EVCF_OUTOFDISKSPACE

Jika bendera ini diatur, pengguna kehabisan ruang disk pada drive. Ketika bendera ini diterima, handler harus agresif tentang mengosongkan ruang disk, bahkan jika mengalihkan performa. Namun, handler tidak boleh menghapus file yang akan menyebabkan aplikasi gagal, atau pengguna kehilangan data.

EVCF_SETTINGSMODE

Jika manajer pembersihan disk dijalankan sesuai jadwal, itu akan mengatur bendera ini. Anda harus menetapkan nilai ke parameter ppwszDisplayName dan ppwszDescription . Jika bendera ini diatur, manajer pembersihan disk tidak akan memanggil IEmptyVolumeCache::GetSpaceUsed, IEmptyVolumeCache::P urge, atau IEmptyVolumeCache::ShowProperties. Karena IEmptyVolumeCache::P urge tidak akan dipanggil, pembersihan harus ditangani oleh IEmptyVolumeCache::Initialize. Handler harus mengabaikan parameter pcwszVolume dan membersihkan file yang tidak diperlukan terlepas dari drive apa yang mereka gunakan. Karena tidak ada kesempatan untuk umpan balik pengguna, hanya file-file yang sangat aman untuk dibersihkan yang harus disentuh.

Bendera ini dapat diteruskan oleh handler kembali ke manajer pembersihan disk:

EVCF_DONTSHOWIFZERO

Atur bendera ini ketika tidak ada file yang akan dihapus. Ketika IEmptyVolumeCache::GetSpaceUsed dipanggil , atur parameter pdwSpaceUsed ke nol, dan manajer pembersihan disk akan menghilangkan handler dari daftarnya.

EVCF_ENABLEBYDEFAULT

Atur bendera ini agar handler diperiksa secara default dalam daftar manajer pembersihan. Ini akan berjalan setiap kali utilitas Pembersihan Disk berjalan, kecuali jika pengguna menghapus kotak centang handler. Setelah kotak centang dikosongkan, handler tidak akan dijalankan sampai pengguna memilihnya lagi.

EVCF_ENABLEBYDEFAULT_AUTO

Atur bendera ini agar handler berjalan secara otomatis selama pembersihan terjadwal. Bendera ini hanya boleh diatur ketika penghapusan file berisiko rendah. Seperti halnya EVCF_ENABLEBYDEFAULT, pengguna dapat memilih untuk tidak menjalankan handler dengan mengosongkan kotak centangnya di daftar manajer pembersihan disk.

EVCF_HASSETTINGS

Atur bendera ini untuk menunjukkan bahwa handler dapat menampilkan UI. Contoh antarmuka pengguna sederhana adalah kotak daftar yang menampilkan file yang dapat dihapus dan memungkinkan pengguna untuk memilih mana yang akan dihapus. Manajer pembersihan disk kemudian akan menampilkan tombol di bawah deskripsi handler pembersihan. Pengguna mengklik tombol ini untuk meminta UI. Teks tombol default adalah "Pengaturan", tetapi handler dapat menentukan teks yang berbeda dengan mengatur nilai AdvancedButtonText di kunci registrinya.

EVCF_REMOVEFROMLIST

Atur bendera ini untuk menghapus handler dari daftar manajer pembersihan disk. Semua informasi registri akan dihapus, dan handler tidak dapat dijalankan lagi hingga kunci dan nilainya dipulihkan. Bendera ini digunakan terutama untuk operasi pembersihan satu kali.

Nilai kembali

Jenis: HRESULT

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
S_FALSE	Tidak ada file yang akan dihapus.
E_ABORT	Operasi pembersihan berakhir sebelum waktunya.
E_FAIL	Operasi pembersihan gagal.

Keterangan

Metode ini digunakan oleh manajer pembersihan disk Windows 98. Windows 2000 menggunakan metode InitializeEx yang diekspor oleh IEmptyVolumeCache2.

Gunakan CoTaskMemAlloc untuk mengalokasikan memori untuk string yang dikembalikan melalui ppwszDisplayName dan ppwszDescription. Manajer pembersihan disk akan membebaskan memori ketika tidak lagi diperlukan.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	emptyvc.h
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)