CeWriteFile (RAPI)

9/8/2008

Essa função grava dados em um arquivo em um remoto dispositivo baseado em Windows Embedded CE. IRAPISession::CeWriteFile Inicia gravar dados de arquivo na posição indicada pelo ponteiro de arquivo. Após conclusão de operação de gravação, o ponteiro arquivo é ajustado pelo número de bytes realmente gravados.

Syntax

BOOL CeWriteFile( 
  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 a serem gravados para 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 qualquer causar bytes, mas o carimbo de data/hora para alteração. CeWriteFile Não truncar ou estender o arquivo. Para truncar ou estender um arquivo, use o CeSetEndOfFile função.

  As operações de gravação pipe nomeado em uma rede são limitadas a 65.535 bytes.

• lpNumberOfBytesWritten
  [out] Ponteiro para o número de bytes gravados por chamar essa função. CeWriteFile define esse valor como zero antes de realizar qualquer trabalho ou verificação de erro.

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

Return Value

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

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 levar a dano dos 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	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions
CeCreateFile (RAPI)
CeReadFile (RAPI)
CeSetEndOfFile (RAPI)