_access, _waccess

Makale
02/26/2013

Bir dosya veya salt okunur olup olmadığını belirler.Daha güvenli sürümleri kullanılabilir; see _access_s, _waccess_s.

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

Parametreler

path
Dosya veya dizin yolu.
mode
Okuma/yazma özniteliği.

Dönüş Değeri

Belirtilen mod dosya varsa, her işlevi 0 değerini döndürür.Adlandırılmış dosya yok ya da belirli bir moda sahip değil işlevi –1 değerini döndürür; Bu durumda, errno aşağıdaki tabloda gösterildiği gibi ayarlayın.

EACCES
Erişim reddedildi: dosyanın izni ayarı, belirtilen erişim izin vermez.
ENOENT
Dosya adı veya yolu bulunamadı.
EINVAL
Geçersiz parametre.

Bunlar ve diğer dönüş kodları hakkında daha fazla bilgi için bkz: _doserrno, errno, _sys_errlist ve _sys_nerr.

Notlar

Dosyaları ile birlikte kullanıldığında _access işlevi, belirtilen dosya ya da dizini varsa ve değeri tarafından belirtilen özniteliklere sahip olup olmadığını belirler mode.Dizinler ile kullanıldığında _access yalnızca belirtilen dizinin varolup olmadığını; belirler. de Windows 2000 ve sonrasına, tüm dizinleri okuma ve yazma erişimi.

modedeğer	Denetim dosyası için
00	Yalnızca varlığı
02	Salt yazılır
04	Salt okunur
06	Okuma ve yazma

Bu işlev yalnızca dosya ve dizin ya da değildir, dosya sistemi güvenlik ayarları denetimi yapmaz salt okunur olup olmadığını kontrol eder.Bunun için bir erişim belirteci gerekir.Dosya sistemi güvenliği hakkında daha fazla bilgi için bkz: Erişim belirteçleri.atl sınıfı bu işlevselliği sağlamak için var; see CAccessToken sınıfı.

_waccessgeniş karakter sürümü _access; path bağımsız değişkeni _waccess bir geniş karakter dizesidir._waccessve _access Aksi takdirde aynı şekilde davranır.

Bu işlev parametreleri doğrular.path Olan NULL veya mode geçerli bir moda belirtmiyor geçersiz parametre işleyicisi, açıklandığı şekilde çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilirse, işlevi ayarlar errno için EINVAL ve -1 değerini döndürür.

Genel metin yordamı eşlemeleri

Tchar.h yordamına girildi	_UNICODE ve _mbcs tanımlı değil	Tanımlanan _mbcs	Tanımlanan _UNICODE
_taccess	_access	_access	_waccess

Gereksinimler

Yordamı	Gerekli başlık	İsteğe bağlı üstbilgileri
_access	<io.h>	<errno.h>
_waccess	<wchar.h> veya <io.h>	<errno.h>

Örnek

Aşağıdaki örnek _access crt_ACCESS adlı dosyayı denetlemek için.Var olup ve yazma izin verilip verilmeyeceğini görmek için 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" );
    }
}