Функция SHQueryRecycleBinA (shellapi.h)
Извлекает размер корзины и количество элементов в ней для указанного диска.
Синтаксис
SHSTDAPI SHQueryRecycleBinA(
[in, optional] LPCSTR pszRootPath,
[in, out] LPSHQUERYRBINFO pSHQueryRBInfo
);
Параметры
[in, optional] pszRootPath
Тип: LPCTSTR
Адрес строки, заканчивающейся значением NULL, максимальной длины MAX_PATH содержать путь к корневому диску, на котором находится корзина. Этот параметр может содержать адрес строки с именами дисков, папок и вложенных папок (C:\Windows\System...).
[in, out] pSHQueryRBInfo
Тип: LPSHQUERYRBINFO
Адрес структуры SHQUERYRBINFO , которая получает сведения о корзине. Перед вызовом этого API для элемента cbSize структуры необходимо задать размер структуры.
Возвращаемое значение
Тип: HRESULT
Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
В Windows 2000, если в параметре pszRootPath передается значение NULL, функция завершается сбоем и возвращает код ошибки E_INVALIDARG. В более ранних версиях операционной системы можно передать пустую строку или NULL. Если pszRootPath содержит пустую строку или ЗНАЧЕНИЕ NULL, сведения извлекаются для всех корзин на всех дисках.
Примечание
Заголовок shellapi.h определяет SHQueryRecycleBin в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | shellapi.h |
| Библиотека | Shell32.lib |
| DLL | Shell32.dll (версия 4.71 или более поздняя) |