Función SHEmptyRecycleBinA (shellapi.h)
Vacía la Papelera de reciclaje en la unidad especificada.
Sintaxis
SHSTDAPI SHEmptyRecycleBinA(
[in, optional] HWND hwnd,
[in, optional] LPCSTR pszRootPath,
DWORD dwFlags
);
Parámetros
[in, optional] hwnd
Tipo: HWND
Identificador de la ventana primaria de los cuadros de diálogo que se pueden mostrar durante la operación. Este parámetro puede ser null.
[in, optional] pszRootPath
Tipo: LPCTSTR de
Dirección de una cadena terminada en NULL de longitud máxima MAX_PATH que contiene 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 de unidad, carpeta y nombres de subcarpeta, por ejemplo c:\windows\system. También puede contener una cadena vacía o NULL. Si este valor es una cadena vacía o NULL, se vaciarán todas las papeleras de reciclaje de todas las unidades.
dwFlags
Tipo: DWORD de
Uno o varios de los siguientes valores.
SHERB_NOCONFIRMATION
No se mostrará ningún cuadro de diálogo que confirme la eliminación de los objetos.
SHERB_NOPROGRESSUI
No se mostrará ningún cuadro de diálogo que indique el progreso.
SHERB_NOSOUND
No se reproducirá ningún sonido cuando se complete la operación.
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
Nota
El encabezado shellapi.h define SHEmptyRecycleBin 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) |
| conjunto de API de |
ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393) |