Compartilhar via

LPWSAOVERLAPPED_COMPLETION_ROUTINE função de retorno de chamada (winsock2.h)

  • Artigo

LPWSAOVERLAPPED_COMPLETION_ROUTINE é um tipo de ponteiro de função. Você implementa uma função de retorno de chamada correspondente em seu aplicativo e a passa para funções como WSAIoctl, WSARecv e WSASend, entre outras.

O sistema chama sua função de retorno de chamada quando a operação assíncrona de entrada e saída (E/S) é concluída ou cancelada, e o thread de chamada está em um estado alertável (usando a função SleepEx, MsgWaitForMultipleObjectsEx, WaitForSingleObjectEx ou WaitForMultipleObjectsEx com o parâmetro fAlertable definido como TRUE).

Sintaxe

LPWSAOVERLAPPED_COMPLETION_ROUTINE LpwsaoverlappedCompletionRoutine;

void LpwsaoverlappedCompletionRoutine(
  DWORD dwError,
  DWORD cbTransferred,
  LPWSAOVERLAPPED lpOverlapped,
  DWORD dwFlags
)
{...}

Parâmetros

dwError

Tipo: IN DWORD

O status de conclusão de E/S. Esse parâmetro pode ser um dos códigos de erro do sistema.

cbTransferred

Tipo: IN DWORD

O número de bytes transferidos. Se ocorrer um erro, esse parâmetro será zero.

lpOverlapped

Tipo: IN LPWSAOVERLAPPED

Um ponteiro para a estrutura WSAOVERLAPPED especificada pela função de E/S assíncrona.

O sistema não usa a estrutura WSAOVERLAPPED depois que a rotina de conclusão é chamada, portanto, a rotina de conclusão pode desalocar a memória usada pela estrutura sobreposta.

dwFlags

Tipo: IN DWORD

Sinalizadores associados à chamada.

Valor retornado

Nenhum

Comentários

Consulte LPOVERLAPPED_COMPLETION_ROUTINE.

Requisitos

   
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Cabeçalho winsock2.h