Função _lcreat (winbase.h)

[Essa função é fornecida para compatibilidade com versões de 16 bits do Windows. Novos aplicativos devem usar a função CreateFile .]

Cria ou abre o arquivo especificado. Esta documentação está incluída apenas para solucionar problemas de código existente.

Sintaxe

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

Parâmetros

lpPathName

O nome do arquivo. A cadeia de caracteres deve consistir em caracteres do conjunto de caracteres ANSI do Windows.

iAttribute

Os atributos do arquivo.

Esse parâmetro deve ser definido como um dos valores a seguir.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador de arquivo. Caso contrário, o valor retornado será HFILE_ERROR. Para obter informações de erro estendidas, use a função GetLastError .

Comentários

Se o arquivo não existir, _lcreat criará e abrirá um novo arquivo para gravação. Se o arquivo existir, _lcreat truncará o tamanho do arquivo como zero e o abrirá para leitura e gravação.

Quando a função abre um arquivo, o ponteiro é definido como o início do arquivo.

Use a função _lcreat com cuidado. Ele pode abrir qualquer arquivo, até mesmo um já aberto por outra função.

Requisitos

Confira também

CreateFile