_access _waccess

Článek
03/26/2013

Určuje, pokud je soubor jen pro čtení nebo není.Bezpečnější verze jsou k dispozici; see _access_s _waccess_s.

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

Parametry

path
Cesta k souboru nebo adresáře.
mode
Atribut pro čtení i zápis.

Vrácená hodnota

Funkce vrátí hodnotu 0, pokud má soubor daného režimu.Funkce vrací –1, pokud pojmenovaný soubor neexistuje nebo neobsahuje daného režimu; v tomto případě errno je nastavena podle následující tabulky.

EACCES
Přístup byl odepřen: v souboru nastavení oprávnění neumožňuje zadaný přístup.
ENOENT
Název souboru nebo cesta nebyla nalezena.
EINVAL
Neplatný parametr.

Další informace o těchto a jiných návratové kódy, viz _doserrno, kód chyby, _sys_errlist a _sys_nerr.

Poznámky

Při použití se soubory, _access funkce určuje, zda zadaný soubor nebo adresář existuje a má atributy určené hodnotou mode.Při použití adresáře, _access pouze určuje, zda zadaný adresář existuje; v Windows 2000 a novější operační systémy, všechny adresáře mají přístup Číst a zapisovat.

modehodnota	Soubor kontroly
00	Existence pouze
02	Jen pro zápis
04	Jen pro čtení
06	Čtení a zápis

Tato funkce pouze zkontroluje, zda soubor a adresář jsou jen pro čtení nebo Ne, nekontroluje nastavení zabezpečení systému souborů.Že je třeba přístupový token.Další informace o zabezpečení systému souborů, viz Přístupové tokeny.Třída ATL existuje k zajištění této funkčnosti; see Třída CAccessToken.

_waccessje verze celého znaku _access; path argument _waccess je řetězec znaků wide._waccessa _access chovají jinak shodně.

Tato funkce ověřuje jeho parametry.Pokud path je NULL nebo mode neurčuje platný režim vyvolat neplatný parametr popisovače, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, nastaví funkci errno na EINVAL a vrátí -1.

Obecný Text rutinní mapování

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS, definice	_UNICODE, definice
_taccess	_access	_access	_waccess

Požadavky

Rutina	Požadované záhlaví	Volitelné záhlaví
_access	<io.h>	<errno.h>
_waccess	<wchar.h> nebo <io.h>	<errno.h>

Příklad

Následující příklad používá _access ke kontrole souboru s názvem crt_ACCESS.C a zjistěte, zda existuje a zda je povolen zápis.

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