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

Статья
08/27/2023

Структура WSAOVERLAPPED обеспечивает обмен данными между запуском перекрывающейся операции ввода-вывода и ее последующим завершением. Структура WSAOVERLAPPED совместима со структурой Windows OVERLAPPED .

Синтаксис

typedef struct _WSAOVERLAPPED {
  DWORD    Internal;
  DWORD    InternalHigh;
  DWORD    Offset;
  DWORD    OffsetHigh;
  WSAEVENT hEvent;
} WSAOVERLAPPED, *LPWSAOVERLAPPED;

Члены

Internal

Тип: ULONG_PTR

Зарезервировано для внутреннего использования. Элемент Internal используется внутри сущности, реализующей перекрывающиеся ввод-вывод. Для поставщиков служб, создающих сокеты в качестве дескрипторов устанавливаемой файловой системы (IFS), этот параметр используется базовой операционной системой. Другие поставщики услуг (не поставщики IFS) могут использовать этот параметр при необходимости.

InternalHigh

Тип: ULONG_PTR

Зарезервировано. Используется внутри сущности, реализующей перекрывающийся ввод-вывод. Для поставщиков услуг, которые создают сокеты в виде дескрипторов IFS, этот параметр используется базовой операционной системой. Поставщики nonIFS могут использовать этот параметр при необходимости.

Offset

Тип: DWORD

Зарезервировано для использования поставщиками услуг.

OffsetHigh

Тип: DWORD

Зарезервировано для использования поставщиками услуг.

hEvent

Тип: HANDLE

Если перекрываемая операция ввода-вывода выполняется без подпрограммы завершения ввода-вывода (параметр lpCompletionRoutine операции имеет значение NULL), этот параметр должен содержать допустимый дескриптор для объекта WSAEVENT или иметь значение NULL. Если параметр lpCompletionRoutine вызова не равен NULL, приложения могут использовать этот параметр по мере необходимости.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	winsock2.h