SHEmptyRecycleBinA 関数 (shellapi.h)

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

構文

SHSTDAPI SHEmptyRecycleBinA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR 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