_rmdir, _wrmdir

Usuwa katalog.

Składnia

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

Parametry

dirname
Ścieżka katalogu do usunięcia.

Wartość zwracana

Każda z tych funkcji zwraca wartość 0, jeśli katalog został pomyślnie usunięty. Zwracana wartość -1 wskazuje błąd i errno jest ustawiona na jedną z następujących wartości:

errno Wartość	Stan
ENOTEMPTY	Podana ścieżka nie jest katalogiem, katalog nie jest pusty lub katalog jest bieżącym katalogiem roboczym lub katalogiem głównym.
ENOENT	Ścieżka jest nieprawidłowa.
EACCES	Program ma otwarte dojście do katalogu.

Aby uzyskać więcej informacji na temat tych i innych kodów powrotnych, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Funkcja _rmdir usuwa katalog określony przez dirname. Katalog musi być pusty i nie może być bieżącym katalogem roboczym ani katalogem głównym.

_wrmdir jest wersją szerokoznakową ; _rmdirargument to dirname_wrmdir ciąg o szerokim znaku. _wrmdir i _rmdir zachowywać się identycznie inaczej.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_trmdir	_rmdir	_rmdir	_wrmdir

Wymagania

Procedura	Wymagany nagłówek
_rmdir	<direct.h>
_wrmdir	<direct.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka C.

Przykład

Zobacz przykład dla elementu _mkdir.

Zobacz też

Kontrolka katalogu
_chdir, _wchdir
_mkdir, _wmkdir