SHEmptyRecycleBinW 関数 (shellapi.h)
指定したドライブのごみ箱を空にします。
構文
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 で導入) |