Determine file-access permission.
int _access( const char *path, int mode );
int _waccess( const wchar_t *path, int mode );
Routine | Required Header | Optional Headers | Compatibility |
_access | <io.h> | <errno.h> | Win 95, Win NT |
_waccess | <wchar.h> or <io.h> | <errno.h> | Win NT |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
LIBC.LIB | Single thread static library, retail version |
LIBCMT.LIB | Multithread static library, retail version |
MSVCRT.LIB | Import library for MSVCRT.DLL, retail version |
Return Value
Each of these functions returns 0 if the file has the given mode. The function returns –1 if the named file does not exist or is not accessible in the given mode; in this case, errno is set as follows:
EACCES
Access denied: file’s permission setting does not allow specified access.
ENOENT
Filename or path not found.
Parameters
path
File or directory path
mode
Permission setting
Remarks
When used with files, the _access function determines whether the specified file exists and can be accessed as specified by the value of mode. When used with directories, _access determines only whether the specified directory exists; in Windows NT, all directories have read and write access.
mode Value | Checks File For |
00 | Existence only |
02 | Write permission |
04 | Read permission |
06 | Read and write permission |
_waccess is a wide-character version of _access; the path argument to _waccess is a wide-character string. _waccess and _access behave identically otherwise.
Generic-Text Routine Mappings
TCHAR.H Routine | _UNICODE & _MBCS Not Defined | _MBCS Defined | _UNICODE Defined |
_taccess | _access | _access | _waccess |
Example
/* ACCESS.C: This example uses _access to check the * file named "ACCESS.C" to see if it exists and if * writing is allowed. */ #include <io.h> #include <stdio.h> #include <stdlib.h> void main( void ) { /* Check for existence */ if( (_access( "ACCESS.C", 0 )) != -1 ) { printf( "File ACCESS.C exists\n" ); /* Check for write permission */ if( (_access( "ACCESS.C", 2 )) != -1 ) printf( "File ACCESS.C has write permission\n" ); if( (_access( "ACCESS.C", 4 )) != -1 ) printf( "File ACCESS.C has read permission\n" ); if( (_access( "ACCESS.C", 6 )) != -1 ) printf( "File ACCESS.C has read and write permission\n" ); } else { printf("File ACCESS.C does not exists\n"); } }