次の方法で共有


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

必要条件

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

関連項目

SHQueryRecycleBin の