_umask

Article
03/04/2013

définit le masque d'autorisation de fichier par défaut.un plus version sécurisée de cette fonction est disponible ; consultez _umask_s.

int _umask(
   int pmode 
);

Paramètres

pmode
paramètre d'autorisation par défaut.

Valeur de retour

_umask retourne la valeur précédente d' pmode.Il n'existe aucun retour d'erreur.

Notes

La fonction d' _umask définit le masque d'autorisation de fichier du processus actuel en mode spécifié par pmode*.* Le masque d'autorisation de fichier remplace le paramètre d'autorisation de fichiers créés par _creat, _open, ou _sopen.Si un bit dans le masque est 1, le bit correspondant en valeur demandée de l'autorisation de fichier est défini à 0 (interdit).Si un bit dans le masque est 0, le bit correspondant reste inchangé.Le paramètre d'autorisation pour un nouveau fichier n'est pas défini jusqu'à ce que le fichier est fermé pour la première fois.

L'expression entière pmode contient une ou les deux constantes manifestes suivantes, défini dans le système \STAT.H :

_S_IWRITE
écriture autorisée.
_S_IREAD
lecture autorisée.
_S_IREAD | _S_IWRITE
lecture et écriture autorisées.

Lorsque les deux constantes sont données, elles sont attachées avec l'opérateur de bits OR ( | ).Si l'argument d' pmode est _S_IREAD, vous ne pouvez pas lire (le fichier est en écriture seule).Si l'argument d' pmode est _S_IWRITE, vous ne pouvez pas écrire (le fichier est en lecture seule).Par exemple, si le bit en écriture est défini dans le masque, tous les nouveaux fichiers sont en lecture seule.Notez qu'avec MS-DOS et les systèmes d'exploitation Windows, tous les fichiers sont compréhensibles ; il n'est pas possible d'accorder l'autorisation en écriture seule.Par conséquent, le bit de lecture à _umask n'a aucun effet sur les modes du fichier.

Si pmode n'est pas une combinaison d'une des constantes manifestes ou n'incorpore pas un ensemble de mosaïques constantes, la fonction ignore simplement ceux.

Configuration requise

routine	en-tête requis
_umask	<io.h> <sys/stat.h> , <sys/types.h>

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

bibliothèques

toutes les versions de Bibliothèques runtime C.

Exemple

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