_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_errlist
i _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ą ; _rmdir
argument 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 zdefiniowany |
_UNICODE zdefiniowany |
---|---|---|---|
_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
.