_access, _waccess

Article
03/15/2013

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