Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Структура 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 |