_rmdir, _wrmdir

Löscht ein Verzeichnis.

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

Parameter

  • dirname
    Pfad des zu entfernenden Verzeichnisses.

Rückgabewert

Jede dieser Funktionen gibt 0 zurück, wenn das Verzeichnis gelöscht wird. Bei dem Rückgabewert von 1 gibt einen Fehler an und errno auf einen der folgenden Werte festgelegt:

  • ENOTEMPTY
    Der angegebene Pfad ist kein Verzeichnis, ist das Verzeichnis nicht leer, oder das Verzeichnis ist entweder das aktuelle Arbeitsverzeichnis oder das Stammverzeichnis.

  • ENOENT
    Pfad ist ungültig.

  • EACCES
    Ein Programm verfügt ein geöffnetes Handle das Verzeichnis.

Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Hinweise

Die Funktion _rmdir löscht das Verzeichnis, das von dirname angegeben wird. Das Verzeichnis muss leer sein, und er darf nicht das aktuelle Arbeitsverzeichnis oder das Stammverzeichnis sein.

_wrmdir ist eine Breitzeichenversion von _rmdir. Das dirname-Argument für _wrmdir ist eine Breitzeichenfolge. _wrmdir und _rmdir verhalten sich andernfalls identisch.

Zuordnung generischer Textroutinen

Tchar.h-Routine

_UNICODE und _MBCS nicht definiert

_MBCS definiert

_UNICODE definiert

_trmdir

_rmdir

_rmdir

_wrmdir

Anforderungen

Routine

Erforderlicher Header

_rmdir

<direct.h>

_wrmdir

<direct.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Bibliotheken

Alle Versionen C-Laufzeitbibliotheken.

Beispiel

Im Beispiel für _mkdir.

.NET Framework-Entsprechung

System::IO::Directory::Delete

Siehe auch

Referenz

Verzeichnissteuerung

_chdir, _wchdir

_mkdir, _wmkdir