Función SHQueryRecycleBinA (shellapi.h)
Recupera el tamaño de la Papelera de reciclaje y el número de elementos de ella, para una unidad especificada.
Sintaxis
SHSTDAPI SHQueryRecycleBinA(
[in, optional] LPCSTR pszRootPath,
[in, out] LPSHQUERYRBINFO pSHQueryRBInfo
);
Parámetros
[in, optional] pszRootPath
Tipo: LPCTSTR de
La dirección de un cadena terminada en nullde longitud máxima MAX_PATH contener la ruta de acceso de la unidad raíz en la que se encuentra la Papelera de reciclaje. Este parámetro puede contener la dirección de una cadena con formato con los nombres de unidad, carpeta y subcarpeta (C:\Windows\System...).
[in, out] pSHQueryRBInfo
Tipo: lpSHQUERYRBINFO
Dirección de una estructura de SHQUERYRBINFO que recibe la información de la papelera de reciclaje. El cbSize miembro de la estructura debe establecerse en el tamaño de la estructura antes de llamar a esta API.
Valor devuelto
Tipo: HRESULT
Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.
Observaciones
Con Windows 2000, si se pasa NULL en el parámetro pszRootPath, la función produce un error y devuelve un código de error E_INVALIDARG. En versiones anteriores del sistema operativo, puede pasar una cadena vacía o NULL. Si pszRootPath contiene una cadena vacía o null, se recupera información para todas las papeleras de reciclaje de todas las unidades.
Nota
El encabezado shellapi.h define SHQueryRecycleBin como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
shellapi.h |
| biblioteca de |
Shell32.lib |
| DLL de |
Shell32.dll (versión 4.71 o posterior) |