Поделиться через


Структура WSACOMPLETION (winsock2.h)

Структура WSACOMPLETION указывает параметры уведомления о завершении для вызовов элементов управления ввода-вывода, выполненных в зарегистрированном пространстве имен.

Синтаксис

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;

Members

Type

Тип: WSACOMPLETIONTYPE

Тип уведомления о завершении, необходимый. См. раздел "Замечания".

Parameters

Параметры, необходимые для завершения обратного вызова. Структуры в союзе "Параметры" указывают сведения, необходимые для завершения обратного вызова каждого заданного типа. Например, структура WindowMessage должна быть заполнена, если для типа задано значение NSP_NOTIFY_HWND.

Parameters.WindowMessage

Parameters.WindowMessage.hWnd

Тип: HWND

Дескриптор Windows.

Parameters.WindowMessage.uMsg

Тип: UINT

Дескриптор сообщения.

Parameters.WindowMessage.context

Тип: WPARAM

Контекст сообщения или дескриптора.

Parameters.Event

Parameters.Event.lpOverlapped

Тип: LPWSAOVERLAPPED

Указатель на структуру WSAOVERLAPPED .

Parameters.Apc

Parameters.Apc.lpOverlapped

Тип: LPWSAOVERLAPPED

Указатель на структуру WSAOVERLAPPED .

Parameters.Apc.lpfnCompletionProc

Тип: _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

Указатель на подпрограмму завершения, предоставленного приложением.

Parameters.Port

Parameters.Port.lpOverlapped

Тип: LPWSAOVERLAPPED

Указатель на структуру WSAOVERLAPPED .

Parameters.Port.hPort

Тип: HANDLE

Дескриптор порта.

Parameters.Port.Key

Тип: ULONG_PTR

Указатель на ключ.

Замечания

Структура WSACOMPLETION позволяет предоставлять обратные вызовы в любом из следующих форматов на основе значения, предоставленного в типе:

Формат обратного вызова Значение типа
Голосование NSP_NOTIFY_IMMEDIATELY
Сообщение окна NSP_NOTIFY_HWND
Event NSP_NOTIFY_EVENT
APC NSP_NOTIFY_APC
Порт завершения NSP_NOTIFY_PORT
 

Для функции блокировки задайте для структуры WSACOMPLETION значение NULL.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
Header winsock2.h

См. также

WSANSPIoctl