función _lcreat (winbase.h)

[Esta función se proporciona para la compatibilidad con versiones de 16 bits de Windows. Las nuevas aplicaciones deben usar la función CreateFile .]

Crea o abre el archivo especificado. Esta documentación solo se incluye para solucionar problemas de código existente.

Sintaxis

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

Parámetros

lpPathName

Nombre del archivo. La cadena debe constar de caracteres del juego de caracteres ANSI de Windows.

iAttribute

Atributos del archivo.

Este parámetro debe establecerse en uno de los valores siguientes.

Valor	Significado
0	Normal. Se puede leer desde o escribir en sin restricciones.
1	Solo lectura. No se puede abrir para escribir.
2	Oculto. No se encuentra en la búsqueda de directorios.
4	System. No se encuentra en la búsqueda de directorios.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de archivo. De lo contrario, el valor devuelto es HFILE_ERROR. Para obtener información de error extendida, use la función GetLastError .

Comentarios

Si el archivo no existe, _lcreat crea y abre un nuevo archivo para escribirlo. Si el archivo existe, _lcreat trunca el tamaño del archivo en cero y lo abre para leer y escribir.

Cuando la función abre un archivo, el puntero se establece en el principio del archivo.

Use la función _lcreat con cuidado. Puede abrir cualquier archivo, incluso uno ya abierto por otra función.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

CreateFile