_access_s, _waccess_s
Determina los permisos de lectura y escritura del archivo.Ésta es una versión de _access, _waccess con mejoras de seguridad como se describe en Características de seguridad en CRT.
errno_t _access_s(
const char *path,
int mode
);
errno_t _waccess_s(
const wchar_t *path,
int mode
);
Parámetros
path
Archivo o ruta de acceso del directorio.mode
configuración de permisos.
Valor devuelto
Cada función devuelve 0 si el archivo tiene el modo especificado.La función devuelve un código de error si no existe el archivo con nombre o no está disponible en el modo especificado.En este caso, la función devuelve un código de error de conjunto como sigue y también establece errno al mismo valor.
EACCES
Acceso denegado.La configuración de permisos del archivo no permite el acceso especificado.ENOENT
nombre de archivo o ruta no encontrada.EINVAL
Parámetro no válido.
Para obtener más información, vea errno, _doserrno, _sys_errlist, y _sys_nerr.
Comentarios
Cuando se utiliza con archivos, la función de _access_s determina si el archivo especificado existe y se puede lograr según lo especificado por el valor de mode.Cuando se utiliza con los directorios, _access_s únicamente determina si existe el directorio especificado.en Windows 2000 y sistemas operativos posteriores, todos los directorios tienen acceso de lectura y escritura.
valor mode |
comprueba el archivo para |
---|---|
00 |
Existencia únicamente. |
02 |
permiso de escritura. |
04 |
Permiso de Lectura. |
06 |
Permiso de lectura y escritura. |
El permiso para leer o escribir el archivo no es suficiente para garantizar la capacidad de abrir un archivo.Por ejemplo, si un archivo está bloqueado por otro proceso, no es accesible aunque _access_s devuelve 0.
_waccess_s es una versión con caracteres anchos de _access_s, donde es una cadena de caracteres el argumento de path a _waccess_s de.Si no, _waccess_s y _access_s se comportan exactamente igual.
estas funciones validan sus parámetros.Si path es NULL o mode no especifica un modo válido, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, este errno establecido funciones a EINVAL y a EINVALreturn.
Asignaciones de la rutina de texto genérico
rutina de Tchar.h |
_UNICODE y _MBCS no definido |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_taccess_s |
_access_s |
_access_s |
_waccess_s |
Requisitos
rutina |
Encabezado necesario |
encabezado opcional |
---|---|---|
_access_s |
<io.h> |
<errno.h> |
_waccess_s |
<wchar.h> o <io.h> |
<errno.h> |
Ejemplo
Este ejemplo utiliza _access_s para comprobar el archivo denominado crt_access_s.c para ver si existe y si la escritura está permitida.
// 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" );
}
}
Equivalente en .NET Framework
Vea también
Referencia
_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32