_access, _waccess

아티클
02/21/2013

파일 읽기 전용 인지 여부를 확인 합니다.더 안전한 버전을 사용할 수 있습니다. see _access_s, _waccess_s.

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

매개 변수

path
파일 또는 디렉터리의 경로입니다.
mode
읽기/쓰기 속성입니다.

반환 값

파일 지정 된 모드에 있는 경우 각 함수는 0을 반환 합니다.이름이 지정 된 파일이 존재 하지 않거나 지정 된 모드가 없는 경우 – 1을 반환 하는 함수입니다. 이 경우 errno 는 다음 표에 표시 된 대로 설정 됩니다.

EACCES
액세스 거부: 해당 파일의 사용 권한 설정을 지정한 액세스를 허용 하지 않습니다.
ENOENT
파일 이름 또는 경로 찾을 수 없습니다.
EINVAL
잘못 된 매개 변수입니다.

이러한 기능 및 다른 반환 코드에 대 한 자세한 내용은 참조 하십시오. _doserrno, errno, _sys_errlist, 및 _sys_nerr.

설명

파일을 사용 하는 데 사용 하는 경우는 _access 함수를 지정 된 파일이 나 디렉터리가 존재 하 고 값으로 지정 된 특성을 가진 여부 확인 mode.디렉터리를 사용할 때 _access 확인 지정 된 디렉터리가 있는지 여부입니다. Windows 2000 및 나중에 운영 체제를 모든 디렉터리 읽기 및 쓰기 액세스입니다.

mode 값	검사 파일
00	만 존재
02	쓰기 전용
04	읽기 전용
06	읽기 및 쓰기

이 함수는 파일 및 디렉터리, 파일 시스템 보안 설정을 확인 하지 않습니다 읽기 전용 것인지 확인 합니다.에 액세스 토큰이 필요합니다.파일 시스템 보안에 대 한 자세한 내용은 액세스 토큰.ATL 클래스는이 기능을 제공할 수 있습니다. see CAccessToken 클래스.

_waccess와이드 문자 버전입니다 _access. path 인수를 _waccess 와이드 문자 문자열입니다._waccess및 _access 그렇지을 동일 하 게 작동 합니다.

이 함수의 매개 변수의 유효성을 검사 합니다.경우 path 입니다 NULL 또는 mode 올바른 모드를 지정 하지 않은의 설명에 따라 잘못 된 매개 변수 처리기가 호출 매개 변수 유효성 검사.함수 실행을 계속 수 있으면 설정 errno 에 EINVAL 및-1을 반환 합니다.

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 및 _mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_taccess	_access	_access	_waccess

요구 사항

루틴	필수 헤더	선택적 헤더
_access	<io.h>	<errno.h>
_waccess	<wchar.h> 또는 <io.h>	<errno.h>

예제

다음 예제를 사용 하 여 _access crt_ACCESS 파일을 확인 합니다.C 존재 여부 및 쓰기 허용 되는지 여부를 확인 합니다.

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