LPWSAOVERLAPPED_COMPLETION_ROUTINE コールバック関数 (winsock2.h)

LPWSAOVERLAPPED_COMPLETION_ROUTINE は関数ポインター型です。 アプリに一致するコールバック関数を実装し、そのコールバック関数を WSAIoctl、 WSARecv、 WSASend などの関数に渡します。

システムは、非同期の入出力 (I/O) 操作が完了または取り消され、呼び出し元のスレッドがアラート可能な状態 (SleepEx、MsgWaitForMultipleObjectsEx、WaitForSingleObjectEx、または WaitForMultipleObjectsEx 関数を使用して fAlertable パラメーターが TRUE に設定されている場合) にコールバック関数を呼び出します。

構文

LPWSAOVERLAPPED_COMPLETION_ROUTINE LpwsaoverlappedCompletionRoutine;

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

パラメーター

dwError

型: IN DWORD

I/O 完了状態。 このパラメーターには、 システム エラー コードのいずれかを指定できます。

cbTransferred

型: IN DWORD

転送されたバイト数。 エラーが発生した場合、このパラメーターは 0 です。

lpOverlapped

型: IN LPWSAOVERLAPPED

非同期 I/O 関数によって指定された WSAOVERLAPPED 構造体へのポインター。

システムは、完了ルーチンが呼び出された後に WSAOVERLAPPED 構造体を使用しないため、完了ルーチンは、重複した構造体で使用されるメモリの割り当てを解除できます。

dwFlags

型: IN DWORD

呼び出しに関連付けられているフラグ。

戻り値

なし

解説

「LPOVERLAPPED_COMPLETION_ROUTINE」を参照してください。

要件