funzione _lcreat (winbase.h)

[Questa funzione viene fornita per la compatibilità con le versioni a 16 bit di Windows. Le nuove applicazioni devono usare la funzione CreateFile .

Crea o apre il file specificato. Questa documentazione è inclusa solo per la risoluzione dei problemi relativi al codice esistente.

Sintassi

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

Parametri

lpPathName

Nome del file. La stringa deve essere costituita da caratteri dal set di caratteri WINDOWS ANSI.

iAttribute

Attributi del file.

Questo parametro deve essere impostato su uno dei valori seguenti.

Valore	Significato
0	Normale. Può essere letto da o scritto in senza restrizioni.
1	Di sola lettura. Impossibile aprire per la scrittura.
2	Nascosto. Non trovato dalla ricerca directory.
4	Sistema. Non trovato dalla ricerca directory.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle di file. In caso contrario, il valore restituito è HFILE_ERROR. Per ottenere informazioni sull'errore estese, usare la funzione GetLastError .

Commenti

Se il file non esiste, _lcreat crea e apre un nuovo file per la scrittura. Se il file esiste, _lcreat tronca la dimensione del file su zero e la apre per la lettura e la scrittura.

Quando la funzione apre un file, il puntatore viene impostato sull'inizio del file.

Usare la funzione _lcreat con cura. Può aprire qualsiasi file, anche uno già aperto da un'altra funzione.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

CreateFile