_rmdir, _wrmdir

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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

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.

Bibliotheken

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

Sehen Sie sich das Beispiel für _mkdir.

Siehe auch

Verzeichnissteuerelement
_chdir, _wchdir
_mkdir, _wmkdir