LPWSAOVERLAPPED_COMPLETION_ROUTINE Rückruffunktion (winsock2.h)

  • Artikel

LPWSAOVERLAPPED_COMPLETION_ROUTINE ist ein Funktionszeigertyp. Sie implementieren eine übereinstimmende Rückruffunktion in Ihrer App und übergeben diese unter anderem an Funktionen wie WSAIoctl, WSARecv und WSASend.

Das System ruft Ihre Rückruffunktion auf, wenn der asynchrone Eingabe- und Ausgabevorgang (E/A) abgeschlossen oder abgebrochen wird und sich der aufrufende Thread in einem warnbaren Zustand befindet (mithilfe der Funktion SleepEx, MsgWaitForMultipleObjectsEx, WaitForSingleObjectEx oder WaitForMultipleObjectsEx , wobei der fAlertable-Parameter auf TRUE festgelegt ist).

Syntax

LPWSAOVERLAPPED_COMPLETION_ROUTINE LpwsaoverlappedCompletionRoutine;

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

Parameter

dwError

Typ: IN DWORD

Die E/A-Vervollständigung status. Dieser Parameter kann einer der Systemfehlercodes sein.

cbTransferred

Typ: IN DWORD

Die Anzahl der übertragenen Bytes. Wenn ein Fehler auftritt, ist dieser Parameter null.

lpOverlapped

Typ: IN LPWSAOVERLAPPED

Ein Zeiger auf die WSAOVERLAPPED-Struktur , die von der asynchronen E/A-Funktion angegeben wird.

Das System verwendet die WSAOVERLAPPED-Struktur nicht, nachdem die Vervollständigungsroutine aufgerufen wurde, sodass die Vervollständigungsroutine die Zuordnung des von der überlappenden Struktur verwendeten Arbeitsspeichers aufheben kann.

dwFlags

Typ: IN DWORD

Dem Aufruf zugeordnete Flags.

Rückgabewert

Keine

Bemerkungen

Siehe LPOVERLAPPED_COMPLETION_ROUTINE.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Kopfzeile winsock2.h