Partager via


_access, _waccess

détermine si un fichier est en lecture seule ou pas.plus les versions sécurisées sont disponibles ; consultez _access_s, _waccess_s.

int _access( 
   const char *path, 
   int mode 
);
int _waccess( 
   const wchar_t *path, 
   int mode 
);

Paramètres

  • path
    Fichier ou un chemin d'accès au répertoire.

  • mode
    attribut en lecture/écriture.

Valeur de retour

Chaque fonction retourne 0 si le fichier a le mode donné.Le retour de la fonction - 1 si le fichier nommé n'existe pas ou n'a pas le mode donné ; dans ce cas, errno est défini comme indiqué dans le tableau suivant.

  • EACCES
    accès refusé : le paramètre d'autorisation de fichier n'autorise pas l'accès spécifié.

  • ENOENT
    Nom de fichier ou un chemin d'accès introuvable.

  • EINVAL
    paramètre non valide.

Pour plus d'informations sur ces éléments et d'autres codes de retour, consultez _doserrno, errno, _sys_errlist, et _sys_nerr.

Notes

Lorsqu'elle est utilisée avec des fichiers, la fonction d' _access détermine si le fichier ou le répertoire spécifié existe et a les attributs spécifiés par la valeur d' mode.En cas de utilisation avec les répertoires, _access ne détermine si le répertoire spécifié existe ; dans Windows 2000 et les systèmes d'exploitation ultérieurs, tous les répertoires ont accès en lecture et en écriture.

Valeur de mode

active le fichier pour

00

Existence uniquement

02

en écriture seule

04

En lecture seule

06

en lecture et en écriture

Cette fonction vérifie uniquement, que le fichier et le répertoire sont en lecture seule ou non, il ne vérifie pas les paramètres de sécurité de système de fichiers.Pour les que vous avez besoin d'un jeton d'accès.Pour plus d'informations sur la sécurité de système de fichiers, consultez la jetons d'accès.Une classe ATL existe pour fournir cette fonctionnalité ; consultez Classe de CAccessToken.

_waccess est une version à caractère élargi d' _access; l'argument d' path à _waccess est une chaîne à caractères larges._waccess et _access se comportent de sinon.

cette fonction valide ses paramètres.Si path est NULL ou mode ne spécifie pas de mode valide, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, la fonction définit errno à EINVAL et retourne -1.

mappages de routines de texte générique

routine de Tchar.h

_UNICODE et _MBCS non définis

_MBCS défini

_UNICODE défini

_taccess

_access

_access

_waccess

Configuration requise

routine

en-tête requis

en-têtes facultatifs

_access

<io.h>

<errno.h>

_waccess

<wchar.h> ou <io.h>

<errno.h>

Exemple

L'exemple suivant utilise _access pour activer le fichier nommé crt_ACCESS.C pour voir s'il existe et si l'écriture est autorisé.

// crt_access.c
// compile with: /W1
// This example uses _access to check the file named
// crt_ACCESS.C to see if it exists and if writing is allowed.

#include  <io.h>
#include  <stdio.h>
#include  <stdlib.h>

int main( void )
{
    // Check for existence.
    if( (_access( "crt_ACCESS.C", 0 )) != -1 )
    {
        printf_s( "File crt_ACCESS.C exists.\n" );

        // Check for write permission.
        // Assume file is read-only.
        if( (_access( "crt_ACCESS.C", 2 )) == -1 )
            printf_s( "File crt_ACCESS.C does not have write permission.\n" );
    }
}
  
  

Équivalent .NET Framework

System.IO.FileAccess

Voir aussi

Référence

Gestion de fichiers

_chmod, _wchmod

_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32

_open, _wopen

_stat, fonctions de _wstat