Compartilhar via


_rmdir, _wrmdir

Exclui um Diretório.

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

Parâmetros

  • dirname
    Caminho do diretório a ser removido.

Valor de retorno

Cada uma dessas funções retornará 0 se o diretório é excluído com êxito. Um valor de retorno – 1 indica que ocorreu um erro e errno são definidos como um dos seguintes valores:

  • ENOTEMPTY
    O caminho especificado não é um diretório, o diretório não estiver vazia, o diretório é o diretório de trabalho atual ou o diretório raiz.

  • ENOENT
    O caminho é inválido.

  • EACCES
    Um programa tem um identificador aberto no diretório.

Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.

Comentários

A função de _rmdir exclui o diretório especificado por dirname. O diretório deve estar vazia, e não deve ser o diretório de trabalho atual ou o diretório raiz.

_wrmdir é uma versão de caractere longo de _rmdir; o argumento dirname para _wrmdir é uma cadeia de caractere longo. Caso contrário, _wrmdir e _rmdir, ao contrário, se comportam de forma idêntica.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h

_UNICODE e _MBCS não definidos

_MBCS definido

_UNICODE definido

_trmdir

_rmdir

_rmdir

_wrmdir

Requisitos

Rotina

Cabeçalho necessário

_rmdir

<direct.h>

_wrmdir

<direct.h> ou <wchar.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Bibliotecas

Todas as versões das Bibliotecas em tempo de execução C.

Exemplo

Consulte o exemplo de _mkdir.

Equivalência do .NET Framework

System::IO::Directory::Delete

Consulte também

Referência

Controle de diretório

_chdir, _wchdir

_mkdir, _wmkdir