Voltar à lista
Windows Win32Arquivos & E/Skernel32.dll

WriteFileEx

Como WriteFile, mas invoca uma rotina de conclusão definida pelo usuário quando a escrita assíncrona termina.

Descrição

Contraparte de escrita de ReadFileEx.

Header: fileapi.hDLL: kernel32.dll

Assinatura

BOOL WriteFileEx(
    HANDLE hFile,
    LPCVOID lpBuffer,
    DWORD nNumberOfBytesToWrite,
    LPOVERLAPPED lpOverlapped,
    LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine
);

Parâmetros

ParâmetroTipoDescrição
hFileHANDLEHandle aberto com FILE_FLAG_OVERLAPPED.
lpBufferLPCVOIDBuffer de origem.
nNumberOfBytesToWriteDWORDNúmero de bytes a escrever.
lpOverlappedLPOVERLAPPEDEstrutura de overlapped associada à operação.
lpCompletionRoutineLPOVERLAPPED_COMPLETION_ROUTINEFunção chamada quando a escrita completa e a thread está alertable.

Valor de retorno

Diferente de zero em sucesso (operação enfileirada); 0 em erro.

Códigos de erro (GetLastError)

ERROR_INVALID_HANDLE(6)
O identificador (handle) informado é inválido.
ERROR_IO_PENDING(997)
A operação de E/S sobreposta (overlapped) foi enfileirada e será concluída de forma assíncrona.

Relacionadas

Mesma categoria

CopyFileWCreateDirectoryWCreateFileWDeleteFileWFindCloseFindFirstFileWFindNextFileWFlushFileBuffers