WSACOMPLETION-Struktur (winsock2.h)

Die WSACOMPLETION-Struktur gibt Die Vervollständigungsbenachrichtigungseinstellungen für E/A-Steuerelementaufrufe an, die an einen registrierten Namespace gesendet werden.

Syntax

typedef struct _WSACOMPLETION {
  WSACOMPLETIONTYPE Type;
  union {
    struct {
      HWND   hWnd;
      UINT   uMsg;
      WPARAM context;
    } WindowMessage;
    struct {
      LPWSAOVERLAPPED lpOverlapped;
    } Event;
    struct {
      LPWSAOVERLAPPED                    lpOverlapped;
      LPWSAOVERLAPPED_COMPLETION_ROUTINE lpfnCompletionProc;
    } Apc;
    struct {
      LPWSAOVERLAPPED lpOverlapped;
      HANDLE          hPort;
      ULONG_PTR       Key;
    } Port;
  } Parameters;
} WSACOMPLETION, *PWSACOMPLETION, *LPWSACOMPLETION;

Elemente

Type

Typ: WSACOMPLETIONTYPE

Der Typ der erforderlichen Benachrichtigung über den Abschluss. Weitere Informationen finden Sie in der "Anmerkungen".

Parameters

Die Zum Abschließen des Rückrufs erforderlichen Parameter. Die Strukturen innerhalb der Parameterunion geben Informationen an, die zum Abschließen des Rückrufs jedes bestimmten Typs erforderlich sind. Die WindowMessage-Struktur muss beispielsweise ausgefüllt werden, wenn "Type " auf NSP_NOTIFY_HWND festgelegt ist.

Parameters.WindowMessage

Parameters.WindowMessage.hWnd

Typ: HWND-

Windows-Handle.

Parameters.WindowMessage.uMsg

Typ: UINT

Nachrichtenhandle.

Parameters.WindowMessage.context

Typ: WPARAM

Kontext der Nachricht oder des Handles.

Parameters.Event

Parameters.Event.lpOverlapped

Typ: LPWSAOVERLAPPED

Ein Zeiger auf eine WSAOVERLAPPED-Struktur .

Parameters.Apc

Parameters.Apc.lpOverlapped

Typ: LPWSAOVERLAPPED

Ein Zeiger auf eine WSAOVERLAPPED-Struktur .

Parameters.Apc.lpfnCompletionProc

Typ: _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

Ein Zeiger auf eine vom Anwendung bereitgestellte Abschlussroutine.

Parameters.Port

Parameters.Port.lpOverlapped

Typ: LPWSAOVERLAPPED

Ein Zeiger auf eine WSAOVERLAPPED-Struktur .

Parameters.Port.hPort

Typ: HANDLE

Ein Handle zum Port.

Parameters.Port.Key

Typ: ULONG_PTR

Ein Zeiger auf die Taste.

Bemerkungen

Mit der WSACOMPLETION-Struktur können Rückrufe in einem der folgenden Formate bereitgestellt werden, basierend auf dem wert, der im Typ bereitgestellt wird:

Legen Sie für eine Blockierungsfunktion die WSACOMPLETION-Struktur auf NULL fest.

Anforderungen

Siehe auch

WSANSPIoctl