_umask

Articolo
03/05/2013

Imposta la maschera predefinita di autorizzazione file.Una versione più sicura di questa funzione è disponibile; vedere _umask_s.

int _umask(
   int pmode 
);

Parametri

pmode
Impostazione possibila di autorizzazioni predefinito.

Valore restituito

_umask restituisce il valore precedente di pmode.Non sono presenti ritorni di errore.

Note

_umask la funzione imposta la maschera di autorizzazione file del processo corrente a quella specificata da pmode*.* La maschera di autorizzazione file modifica l'impostazione di autorizzazione di nuovi file creati da _creat, _open, o _sopen.Se un bit nella maschera è 1, il bit corrispondente nel valore obbligatorio dell'autorizzazione del file è impostato su 0 (disattivata).Se un bit nella maschera è 0, il bit corrispondente viene lasciato invariato.L'impostazione di autorizzazione per un nuovo file non è impostata fino alla chiusura per la prima volta il file.

l'espressione Integer pmode contiene una o entrambe le seguenti costanti manifesto, definito nel sistema \STAT.H:

_S_IWRITE
Scrittura valida.
_S_IREAD
Lettura valida.
_S_IREAD | _S_IWRITE
lettura e scrittura consentite.

Quando entrambe le costanti vengono fornite, vengono unite con l'operatore OR bit per bit ( | ).se pmode l'argomento è _S_IREAD, leggere non è consentita (il file è di sola scrittura).se pmode l'argomento è _S_IWRITE, scrivere non è consentita (il file è di sola lettura).Ad esempio, se il bit di scrittura è impostato nella maschera, tutti i nuovi file verranno di sola lettura.Si noti che con MS-DOS e i sistemi operativi Windows, tutti i file leggibili; non è possibile fornire l'autorizzazione di sola scrittura.Pertanto, impostando il bit con lettura _umask non ha effetto sulle modalità del file.

se pmode non è una combinazione di una delle costanti manifesto o non include un set alternate costanti, la funzione semplicemente ignorati da quelli.

Requisiti

routine	Intestazione di associazione
_umask	<io.h> , <sistema/stat.h> , <sistema/types.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Librerie

Tutte le versioni di Librerie di runtime del linguaggio C.

Esempio

// 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 );
}