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 |