LPWSAOVERLAPPED_COMPLETION_ROUTINE funzione di callback (winsock2.h)

LPWSAOVERLAPPED_COMPLETION_ROUTINE è un tipo di puntatore a funzione. Implementare una funzione di callback corrispondente nell'app e passarla a funzioni come WSAIoctl, WSARecv e WSASend, tra le altre.

Il sistema chiama la funzione di callback quando l'operazione di input e output asincrona (I/O) viene completata o annullata e il thread chiamante si trova in uno stato di avviso (tramite la funzione SleepEx, MsgWaitForMultipleObjectsEx, WaitForSingleObjectEx o WaitForMultipleObjectsEx con il parametro fAlertable impostato su TRUE).

Sintassi

LPWSAOVERLAPPED_COMPLETION_ROUTINE LpwsaoverlappedCompletionRoutine;

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

Parametri

dwError

Tipo: IN DWORD

Stato di completamento di I/O. Questo parametro può essere uno dei codici di errore di sistema.

cbTransferred

Tipo: IN DWORD

Il numero di byte trasferiti. Se si verifica un errore, questo parametro è zero.

lpOverlapped

Tipo: IN LPWSAOVERLAPPED

Puntatore alla struttura WSAOVERLAPPED specificata dalla funzione di I/O asincrona.

Il sistema non usa la struttura WSAOVERLAPPED dopo la chiamata della routine di completamento, quindi la routine di completamento può deallocare la memoria utilizzata dalla struttura sovrapposta.

dwFlags

Tipo: IN DWORD

Flag associati alla chiamata.

Valore restituito

nessuno

Osservazioni

Vedere LPOVERLAPPED_COMPLETION_ROUTINE.

Requisiti

Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Intestazione	winsock2.h