CeReadFile (RAPI)
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Esta função lê dados de um arquivo em um remoto dispositivo baseado em Windows Embedded CE. O operação de leitura inicia a posição indicada pelo ponteiro de arquivo. Após conclusão de operação de leitura, o ponteiro arquivo é ajustado pelo número de bytes realmente ler.
Syntax
BOOL CeReadFile (
HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
LPDWORD lpNumberOfBytesRead,
LPOVERLAPPED lpOverlapped
);
Parameters
- hFile
[no] Identificador para o arquivo seja ler. O identificador de arquivo deve ter sido criado com acessar GENERIC_READ para o arquivo. Este parâmetro não pode ser um identificador Soquete.
- lpBuffer
[out] Ponteiro para a reserva que recebe os dados ler a partir de arquivo.
- nNumberOfBytesToRead
[no] Número de bytes a ser ler a partir de arquivo.
- lpNumberOfBytesRead
[out] Ponteiro para o número de bytes ler. CeReadFile define esse valor como zero antes de realizar qualquer trabalho ou verificação de erro.
- lpOverlapped
[no] Sem suporte; Definir como NULL.
Return Value
O CeReadFile função retorna quando uma do seguinte for verdadeira: o número de bytes solicitados foi ler ou um erro ocorrerá.
Nonzero indica sucesso. Zero indica falha. Se o valor de retorno é diferente de zero e o número de bytes ler for zero, o ponteiro arquivo foi além de atual final do arquivo no tempo da operação de leitura. 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 leitura se sobrepõe a parte bloqueada, essa função falhará.
Acessar o buffer de entrada enquanto um operação de leitura está usando a reserva pode levar a dano dos dados ler em que reserva. Aplicativos não devem ler a partir, Gravação para, reallocate ou livre de buffer de entrada que está usando um operação de leitura até as operação de leitura completa.
O ReadFile função pode falhar e retornar ERROR_INVALID_USER_BUFFER ou ERROR_NOT_ENOUGH_MEMORY sempre que há muitas pendente solicitações assíncrono E/S.
Quando um síncrono operação de leitura atingir o final de um arquivo, ReadFile Retorna TRUE e define *lpNumberOfBytesRead para zero. Windows Embedded CE faz não suporte leitura assíncrona operações em arquivos.
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 |