SHEmptyRecycleBinW 関数 (shellapi.h)

[アーティクル]
03/09/2024

指定したドライブのごみ箱を空にします。

構文

SHSTDAPI SHEmptyRecycleBinW(
  [in, optional] HWND    hwnd,
  [in, optional] LPCWSTR pszRootPath,
                 DWORD   dwFlags
);

パラメーター

[in, optional] hwnd

型: HWND

操作中に表示される可能性があるダイアログボックスの親ウィンドウへのハンドル。このパラメーターは、NULL でもかまいません。

[in, optional] pszRootPath

種類: LPCTSTR

ごみ箱が配置されているルートドライブのパスを含む最大長MAX_PATHの null で終わる文字列のアドレス。このパラメーターには、ドライブ、フォルダー、サブフォルダーの名前で書式設定された文字列のアドレス (c:\windows\system など) を含めることができます。空の文字列または NULL を含めることもできます。この値が空の文字列または NULL の場合、すべてのドライブのすべてのごみ箱が空になります。

dwFlags

型: DWORD

次の値のうち 1 つ以上。

SHERB_NOCONFIRMATION

オブジェクトの削除を確認するダイアログボックスは表示されません。

SHERB_NOPROGRESSUI

進行状況を示すダイアログボックスは表示されません。

SHERB_NOSOUND

操作が完了すると、サウンドは再生されません。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

注釈

注意

shellapi.h ヘッダーは、SHEmptyRecycleBin をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shellapi.h
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 4.71 以降)
API セット	ext-ms-win-shell-shell32-l1-2-2 (Windows 10 バージョン 10.0.14393 で導入)

こちらもご覧ください

SHQueryRecycleBin