Share via

Função _lcreat (winbase.h)

  • Artigo

[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.

Valor Significado
0
 Normal. Pode ser lido ou gravado em sem restrição.
1
 Somente leitura. Não é possível abrir para gravação.
2
 Oculto. Não encontrado pela pesquisa de diretório.
4
 System. Não encontrado pela pesquisa de diretório.

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

Requisito Valor
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CreateFile