WriteFile

9/8/2008

Essa função grava dados em um arquivo, começando a posição indicado pelo ponteiro de arquivo. Após conclusão de operação de gravação, o ponteiro arquivo é ajustado pelo número de bytes gravados.

Uma versão RAPI dessa função existe chamado CeWriteFile (RAPI).

Syntax

BOOL WriteFile( 
  HANDLE hFile, 
  LPCVOID lpBuffer, 
  DWORD nNumberOfBytesToWrite, 
  LPDWORD lpNumberOfBytesWritten, 
  LPOVERLAPPED lpOverlapped
); 

Parameters

• hFile
  [no] Identificador para o arquivo a serem gravados para. O identificador de arquivo deve ter sido criado com acessar GENERIC_WRITE para o arquivo.

• lpBuffer
  [no] Ponteiro para a reserva que contém os dados para gravar o arquivo.

• nNumberOfBytesToWrite
  [no] Número de bytes a gravar o arquivo.

  Um valor de zero especifica um NULL operação de gravação. Um NULL operação de gravação não grava os bytes, mas causar carimbo de tempo a alteração. Essa função não truncar o arquivo. Para truncar ou estender um arquivo, use a função SetEndOfFile.

• lpNumberOfBytesWritten
  [out] Ponteiro para o número de bytes gravados por chamar essa função. Essa função configura esse valor como zero antes de levar ação ou verificando erros.

• lpOverlapped
  [no] Sem suporte. Definir como NULL.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Se parte o arquivo está bloqueado por outro processo e a operação de gravação se sobrepõe a parte bloqueada, essa função falhará.

Acessando a reserva saída enquanto um operação de gravação está usando a reserva pode danificar os dados gravados a partir dessa reserva. Aplicativos não devem ler a partir, Gravação para, reallocate ou livre conclui a reserva saída que está usando um operação de gravação até a operação de gravação.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions
CreateFile
ReadFile
SetEndOfFile