Fungsi SHEmptyRecycleBinA (shellapi.h)

Artikel
03/01/2024

Mengolah Keranjang Sampah pada drive yang ditentukan.

Sintaks

SHSTDAPI SHEmptyRecycleBinA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR pszRootPath,
                 DWORD  dwFlags
);

Parameter

[in, optional] hwnd

Jenis: HWND

Handel ke jendela induk dari kotak dialog apa pun yang mungkin ditampilkan selama operasi. Parameter ini bisa NULL.

[in, optional] pszRootPath

Jenis: LPCTSTR

Alamat string panjang maksimum yang dihentikan null MAX_PATH yang berisi jalur drive akar tempat Keranjang Sampah berada. Parameter ini dapat berisi alamat string yang diformat dengan nama drive, folder, dan subfolder, misalnya c:\windows\system. Ini juga dapat berisi string kosong atau NULL. Jika nilai ini adalah string kosong atau NULL, semua Keranjang Sampah pada semua drive akan dikosongkan.

dwFlags

Jenis: DWORD

Satu atau beberapa nilai berikut ini.

SHERB_NOCONFIRMATION

Tidak ada kotak dialog yang mengonfirmasi penghapusan objek yang akan ditampilkan.

SHERB_NOPROGRESSUI

Tidak ada kotak dialog yang menunjukkan kemajuan akan ditampilkan.

SHERB_NOSOUND

Tidak ada suara yang akan diputar ketika operasi selesai.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Catatan

Header shellapi.h mendefinisikan SHEmptyRecycleBin sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shellapi.h
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)
Set API	ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

SHQueryRecycleBin

Bagikan melalui