_rmdir, _wrmdir

Elimina una directory.

Sintassi

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

Parametri

dirname
Percorso della directory da rimuovere.

Valore restituito

Ognuna di queste funzioni restituisce 0 se la directory viene eliminata correttamente. Il valore restituito -1 indica un errore e errno viene impostato su uno dei valori seguenti:

Valore errno Condizione
ENOTEMPTY Il percorso specificato non è una directory, la directory non è vuota o la directory è la directory di lavoro corrente o la directory radice.
ENOENT Il percorso non è valido.
EACCES Un programma ha un handle aperto per la directory.

Per altre informazioni su questi e altri codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

La funzione _rmdir elimina la directory specificata da dirname. La directory deve essere vuota e non deve essere la directory di lavoro corrente o la directory radice.

_wrmdir è una versione a caratteri wide di _rmdir; l'argomento dirname in _wrmdir è una stringa di caratteri wide. In caso contrario,_wrmdir e _rmdir si comportano in modo identico.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine Tchar.h _UNICODE e _MBCS non definito _MBCS Definito _UNICODE Definito
_trmdir _rmdir _rmdir _wrmdir

Requisiti

Ciclo Intestazione obbligatoria
_rmdir <direct.h>
_wrmdir <direct.h> o <wchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie

Tutte le versioni delle librerie di runtime C.

Esempio

Vedere l'esempio per _mkdir.

Vedi anche

Controllo directory
_chdir, _wchdir
_mkdir, _wmkdir