_umask

Artigo
02/25/2013

Define a máscara de permissão de arquivo padrão.Uma versão mais segura desta função está disponível. see _umask_s.

int _umask(
   int pmode 
);

Parâmetros

pmode
Configuração de permissão padrão.

Valor de retorno

_umaskRetorna o valor anterior da pmode.Não há nenhum retorno de erro.

Comentários

O _umask função define a máscara de permissão de arquivo do processo atual para o modo especificado por pmode*.* A máscara de permissão de arquivo modifica a configuração de permissão de novos arquivos criados por _creat, _open, ou _sopen.Se um bit na máscara for 1, o bit correspondente no valor de permissão solicitada do arquivo é definido como 0 (desativado).Se um bit na máscara for 0, o bit correspondente é deixado inalterado.A configuração de permissão para um novo arquivo não está definida até que o arquivo é fechado pela primeira vez.

A expressão de inteiro pmode contém uma ou ambas das seguintes constantes manifesto, definidas em SYS\STAT.H:

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

Quando as duas constantes forem fornecidas, elas se unem com o (operador bit a bit ou | ).Se a pmode argumento é _S_IREAD, não é permitida a leitura (o arquivo é somente gravação).Se a pmode argumento é _S_IWRITE, escrita não é permitida (o arquivo é somente leitura).Por exemplo, se o bit de gravação está definido na máscara, todos os novos arquivos será somente leitura.Observe que, com o MS-DOS e os sistemas operacionais Windows, todos os arquivos são legíveis; não é possível conceder a permissão somente para gravação.Portanto, definindo a leitura de bits com _umask não tem efeito sobre os modos do arquivo.

Se pmode não é uma combinação de uma das constantes manifesto ou incorpora um conjunto alternativo de constantes, a função irá simplesmente ignorar aqueles.

Requisitos

Rotina	Cabeçalho necessário
_umask	<io.h>, <sys/stat.h>, <sys/types.h>

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

Bibliotecas

Todas as versões da bibliotecas de tempo de execução c.

Exemplo

// crt_umask.c
// compile with: /W3
// This program uses _umask to set
// the file-permission mask so that all future
// files will be created as read-only files.
// It also displays the old mask.
#include <sys/stat.h>
#include <sys/types.h>
#include <io.h>
#include <stdio.h>

int main( void )
{
   int oldmask;

   /* Create read-only files: */
   oldmask = _umask( _S_IWRITE ); // C4996
   // Note: _umask is deprecated; consider using _umask_s instead
   printf( "Oldmask = 0x%.4x\n", oldmask );
}