_rmdir, _wrmdir

  • Artikel

Löscht ein Verzeichnis.

Syntax

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

Parameter

dirname
Der Pfad des Verzeichnisses, das entfernt werden soll.

Rückgabewert

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

Wert vom Typ errno Bedingung
ENOTEMPTY Der angegebene Pfad ist kein Verzeichnis, das Verzeichnis ist nicht leer, oder das Verzeichnis ist entweder das aktuelle Arbeitsverzeichnis oder das Stammverzeichnis.
ENOENT Der Pfad ist ungültig.
EACCES Ein Programm verfügt über ein geöffnetes Handle des Verzeichnisses.

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

Hinweise

Die _rmdir-Funktion löscht das durch dirname angegebene Verzeichnis. Das Verzeichnis muss leer sein, und es darf sich nicht um das aktuelle Arbeitsverzeichnis oder das Stammverzeichnis handeln.

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

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping 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.

Libraries

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

Ein Beispiel hierfür finden Sie unter _mkdir.

Siehe auch

Verzeichnissteuerelement
_chdir, _wchdir
_mkdir, _wmkdir