WSACOMPLETION-Struktur (winsock2.h)

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

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;

Member

Type

Typ: WSACOMPLETIONTYPE

Der Typ der erforderlichen Vervollständigungsbenachrichtigung. Siehe Hinweise.

Parameters

Die Parameter, die zum Abschließen des Rückrufs erforderlich sind. Die Strukturen innerhalb der Parameterunion geben Informationen an, die für den Abschluss des Rückrufs jedes angegebenen Typs erforderlich sind. Beispielsweise muss die WindowMessage-Struktur 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 von der Anwendung bereitgestellte Vervollständigungsroutine.

Parameters.Port

Parameters.Port.lpOverlapped

Typ: LPWSAOVERLAPPED Ein Zeiger auf eine WSAOVERLAPPED-Struktur .

Parameters.Port.hPort

Typ: HANDLE Ein Handle für den Port.

Parameters.Port.Key

Typ: ULONG_PTR Ein Zeiger auf den Schlüssel.

Hinweise

Die WSACOMPLETION-Struktur ermöglicht die Angabe von Rückrufen in einem der folgenden Formate, basierend auf dem in Type angegebenen Wert:

Rückrufformat	Typwert
Abruf	NSP_NOTIFY_IMMEDIATELY
Fenstermeldung	NSP_NOTIFY_HWND
Ereignis	NSP_NOTIFY_EVENT
APC	NSP_NOTIFY_APC
Vervollständigungsport	NSP_NOTIFY_PORT

 

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

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winsock2.h

Weitere Informationen

WSANSPIoctl