_access_s、_waccess_s

更新 : 2007 年 11 月

ファイルの読み取りおよび書き込みアクセス許可を判断します。この関数は、「CRT のセキュリティ強化」に説明されているように、_access、_waccess のセキュリティが強化されたバージョンです。

errno_t _access_s( 
   const char *path, 
   int mode 
);
errno_t _waccess_s( 
   const wchar_t *path, 
   int mode 
);

パラメータ

• path
  ファイルまたはディレクトリのパス。

• mode
  権限の設定。

戻り値

指定されたモードがファイルに設定されている場合は、各関数とも 0 を返します。指定されたファイルが存在しない場合または指定されたモードでアクセスできない場合、この関数はエラー コードを返します。この場合、この関数は次のようなセットからエラー コードを返し、errno も同じ値に設定します。

• EACCES
  アクセスの拒否。ファイルのアクセス許可の設定により、指定されたアクセスができません。

• ENOENT
  ファイル名またはパス名が見つかりません。

• EINVAL
  無効なパラメータ。

詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。

解説

_access_s 関数は、ファイルで使用された場合、指定したファイルが存在するかどうか、および mode 値で指定したアクセスが可能かどうかを判断します。ディレクトリで使用された場合、_access_s 関数は指定したディレクトリが存在するかどうかだけを判断します。Windows 2000 以降のオペレーティング システムでは、すべてのディレクトリに読み取りアクセスおよび書き込みアクセスが許可されています。

ファイルの読み取りまたは書き込みアクセス許可は、ファイルを開くには十分ではありません。たとえば、ファイルが別のプロセスによってロックされていると、_access_s が 0 を返す場合でも、このファイルにアクセスできない場合があります。

_waccess_s 関数は、_access_s 関数のワイド文字バージョンであり、_waccess_s 関数の引数 path は、ワイド文字列です。それ以外では、_waccess_s と _access_s の動作は同じです。

これらの関数では、パラメータの検証が行われます。path が NULL の場合または mode で指定するモードが無効な場合は、「パラメータの検証」に説明されているように、無効なパラメータ ハンドラが呼び出されます。実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、EINVAL を返します。

汎用テキスト ルーチンのマップ

必要条件

使用例

この例では、_access_s を使用して、crt_access_s.c という名前のファイルについて、ファイルが存在するかどうか、および書き込みが許可されているかどうかを確認します。

// crt_access_s.c

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

int main( void )
{
    errno_t err = 0;

    // Check for existence. 
    if ((err = _access_s( "crt_access_s.c", 0 )) == 0 )
    {
        printf_s( "File crt_access_s.c exists.\n" );

        // Check for write permission. 
        if ((err = _access_s( "crt_access_s.c", 2 )) == 0 )
        {
            printf_s( "File crt_access_s.c does have "
                      "write permission.\n" );
        }
        else
        {
            printf_s( "File crt_access_s.c does not have "
                      "write permission.\n" );
        }
    }
    else
    {
        printf_s( "File crt_access_s.c does not exist.\n" );
    }
}

File crt_access_s.c exists.
File crt_access_s.c does not have write permission.

.NET Framework の相当するアイテム

System.IO.FileAccess

参照

参照

ファイル処理

_access、_waccess

_chmod、_wchmod

_fstat、_fstat32、_fstat64、_fstati64、_fstat32i64、_fstat64i32

_open、_wopen

_stat、_wstat 関数