_rmdir, _wrmdir

Elimina un directorio.

Sintaxis

int _rmdir(
   const char *dirname
);
int _wrmdir(
   const wchar_t *dirname
);

Parámetros

dirname
Ruta de acceso del directorio que se va a quitar.

Valor devuelto

Cada una de estas funciones devuelve 0 si el directorio se elimina correctamente. Un valor devuelto de -1 indica un error y errno se establece en uno de los siguientes valores:

Valor de errno	Condición
ENOTEMPTY	La ruta de acceso dada no es un directorio, el directorio no está vacío o el directorio es el directorio de trabajo actual o el directorio raíz.
ENOENT	La ruta de acceso no es válida.
EACCES	Un programa tiene un identificador abierto en el directorio.

Para obtener más información sobre estos y otros códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.

Comentarios

La función _rmdir elimina el directorio especificado por dirname. El directorio debe estar vacío y no debe ser el directorio de trabajo actual ni el directorio raíz.

_wrmdir es una versión con caracteres anchos de _rmdir; el argumento dirname para _wrmdir es una cadena de caracteres anchos. Por lo demás,_wrmdir y _rmdir se comportan de forma idéntica.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_trmdir	_rmdir	_rmdir	_wrmdir

Requisitos

Routine	Encabezado necesario
_rmdir	<direct.h>
_wrmdir	<direct.h> o <wchar.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Ejemplo

Vea el ejemplo de _mkdir.

Consulte también

Control de directorio
_chdir, _wchdir
_mkdir, _wmkdir