Функция SHEmptyRecycleBinA (shellapi.h)

Статья
11/20/2024

Очищает корзину на указанном диске.

Синтаксис

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

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна любых диалоговых окон, которые могут отображаться во время операции. Этот параметр может быть NULL.

[in, optional] pszRootPath

Тип: LPCTSTR

Адрес строки, завершаемой значением NULL, максимальной длины MAX_PATH, содержащей путь корневого диска, на котором находится корзина. Этот параметр может содержать адрес строки, форматируемой с именами дисков, папок и вложенных папок, например c:\windows\system. Он также может содержать пустую строку или NULL. Если это значение является пустой строкой или NULL, все корзины на всех дисках будут очищаться.

dwFlags

Тип: DWORD

Одно или несколько следующих значений.

SHERB_NOCONFIRMATION

Диалоговое окно без подтверждения удаления объектов будет отображаться.

SHERB_NOPROGRESSUI

Диалоговое окно не отображается, указывающее, что ход выполнения будет отображаться.

SHERB_NOSOUND

Звук не будет воспроизводиться после завершения операции.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Заметка

Заголовок shellapi.h определяет SHEmptyRecycleBin как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, 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

Поделиться через