Partilhar via


_chmod, _wchmod

Altera as configurações de permissão de arquivo.

int _chmod( 
   const char *filename,
   int pmode 
);
int _wchmod( 
   const wchar_t *filename,
   int pmode 
);

Parâmetros

  • filename
    Nome do arquivo existente.

  • pmode
    Configuração de permissão para o arquivo.

Valor de retorno

Essas funções retornam 0 se a configuração de permissão for alterada com êxito.Um valor retornado de – 1 indica falha.Se o arquivo especificado pode não ser encontrado, errno é conjunto para ENOENT; Se for inválido, um parâmetro errno é conjunto para EINVAL.

Comentários

The _chmod função altera a configuração de permissão do arquivo especificado pelo filename*.* A configuração de permissão controla o acesso de leitura e gravar para o arquivo.A expressão de inteiro pmode contém uma das seguintes constantes manifesto, definidas no SYS\Stat.h ou ambas.

  • _S_IWRITE
    Permissão de escrita.

  • _S_IREAD
    Permissão de leitura.

  • _S_IREAD | _S_IWRITE
    Permissão de leitura e gravação.

Quando ambas as constantes são determinados, eles fazem parte com o bit a bit OR () operador |).Se não receber permissão de gravar, o arquivo é somente leitura.Observe que todos os arquivos são sempre legíveis; não é possível conceder a permissão somente gravar.Assim, os modos de _S_IWRITE e _S_IREAD | _S_IWRITE são equivalentes.

_wchmod é uma versão de caractere largo da _chmod; o filename argumento para _wchmod é uma seqüência de caracteres largos. _wchmod e _chmod tenham comportamento idêntico caso contrário.

Esta função valida os parâmetros.If pmode não é uma combinação de uma das constantes manifesto ou incorpora um conjunto alternativo de constantes, a função simplesmente ignora os. If filename é NULL, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, errno é conjunto para EINVAL e a função retornará -1.

Mapeamentos de rotina de texto genérica

Rotina tchar.h

_UNICODE e _MBCS não definido

_MBCS definido

_UNICODE definido

_tchmod

_chmod

_chmod

_wchmod

Requisitos

Rotina

Cabeçalho necessário

Cabeçalho opcional

_chmod

<io.h>

<sys/types.h>, <sys/stat.h>, <errno.h>

_wchmod

<io.h> ou <wchar.h>

<sys/types.h>, <sys/stat.h>, <errno.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Exemplo

// crt_chmod.c
// This program uses _chmod to
// change the mode of a file to read-only.
// It then attempts to modify the file.
//

#include <sys/types.h>
#include <sys/stat.h>
#include <io.h>
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>

// Change the mode and report error or success 
void set_mode_and_report(char * filename, int mask)
{
   // Check for failure 
   if( _chmod( filename, mask ) == -1 )
   {
      // Determine cause of failure and report. 
      switch (errno)
      {
         case EINVAL:
            fprintf( stderr, "Invalid parameter to chmod.\n");
            break;
         case ENOENT:
            fprintf( stderr, "File %s not found\n", filename );
            break;
         default:
            // Should never be reached 
            fprintf( stderr, "Unexpected error in chmod.\n" );
       }
   }
   else
   {
      if (mask == _S_IREAD)
        printf( "Mode set to read-only\n" );
      else if (mask & _S_IWRITE)
        printf( "Mode set to read/write\n" );
   }
   fflush(stderr);
}

int main( void )
{ 

   // Create or append to a file. 
   system( "echo /* End of file */ >> crt_chmod.c_input" );

   // Set file mode to read-only: 
   set_mode_and_report("crt_chmod.c_input ", _S_IREAD );
   
   system( "echo /* End of file */ >> crt_chmod.c_input " );

   // Change back to read/write: 
   set_mode_and_report("crt_chmod.c_input ", _S_IWRITE );
 
   system( "echo /* End of file */ >> crt_chmod.c_input " ); 
} 

A line of text.

Mode set to read-only Access is denied. Mode set to read/write

Equivalente do NET Framework

Consulte também

Referência

Manipulação de arquivos

_access, _waccess

_creat, _wcreat

_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32

_Open, _wopen

_stat, _wstat funções