Структура WSAMSG (ws2def.h)

Структура WSAMSG используется с функциями LPFN_WSARECVMSG (WSARecvMsg) и WSASendMsg для хранения сведений об адресе и необязательных элементах управления подключенных и неподключенных сокетах, а также массива буферов, используемых для хранения данных сообщений.

Синтаксис

typedef struct _WSAMSG {
  LPSOCKADDR name;
  INT        namelen;
  LPWSABUF   lpBuffers;
#if ...
  ULONG      dwBufferCount;
#else
  DWORD      dwBufferCount;
#endif
  WSABUF     Control;
#if ...
  ULONG      dwFlags;
#else
  DWORD      dwFlags;
#endif
} WSAMSG, *PWSAMSG, *LPWSAMSG;

Члены

name

Тип: LPSOCKADDR

Указатель на структуру SOCKET_ADDRESS , в котором хранятся сведения об удаленном адресе. Используется только с несвязанными сокетами.

namelen

Тип: INT

Длина в байтах структуры SOCKET_ADDRESS , на который указывает элемент pAddr . Используется только с несвязанными сокетами.

lpBuffers

Тип: LPWSABUF

Массив структур WSABUF , используемых для получения данных сообщения. Возможность элемента lpBuffers содержать несколько буферов позволяет использовать точечный/сборный ввод-вывод.

dwBufferCount

Тип: DWORD

Количество буферов, на которые указывает элемент lpBuffers .

Control

Тип: WSABUF

Структура типа WSABUF , используемая для указания необязательных данных элемента управления. См. заметки.

dwFlags

Тип: DWORD

Один или несколько флагов элемента управления, указанных в качестве логического ИЛИ значений. Возможные значения для элемента dwFlags во входных данных определяются в файле заголовка Winsock2.h. Возможные значения для элемента dwFlags в выходных данных определяются в файле заголовка Ws2def.h, который автоматически включается в файл заголовка Winsock2.h.

Комментарии

В microsoft пакет средств разработки программного обеспечения для Windows (SDK) версия этой структуры для использования в Windows Vista определяется с типом данных для членов dwBufferCount и dwFlags как ULONG. При компиляции приложения, если целевой платформой является Windows Vista и более поздних версий (NTDDI_VERSION >= NTDDI_LONGHORN, _WIN32_WINNT >= 0x0600 или WINVER >= 0x0600), типом данных для членов dwBufferCount и dwFlags является ULONG.

Windows Server 2003 и Windows XP: При компиляции приложения типом данных для членов dwBufferCount и dwFlags является DWORD.

На Windows SDK, выпущенном для Windows Vista и более поздних версий, структура WSAMSG определена в файле заголовка Ws2def.h. Обратите внимание, что файл заголовка Ws2def.h автоматически включается в Winsock2.h и никогда не должен использоваться напрямую.

Если датаграмма или управляющие данные усекаются во время передачи, функция, используемая в связи со структурой WSAMSG , возвращает SOCKET_ERROR а вызов функции WSAGetLastError возвращает WSAEMSGSIZE . Приложение определяет, что было усечено, проверив наличие флагов MSG_TRUNC и (или) MSG_CTRUNC.

Использование элемента управления

В следующей таблице перечислены различные варианты использования данных управления, доступных для использования в элементе Control для IPv4 и IPv6.

Управляющие данные состоят из одного или нескольких объектов данных управления, каждый из которых начинается со структуры WSACMSGHDR , определенной следующим образом.

struct wsacmsghdr {
  UINT        cmsg_len;
  INT         cmsg_level;
  INT         cmsg_type;
  /* followed by UCHAR cmsg_data[] */
} WSACMSGHDR;

Ниже приведены элементы структуры WSACMSGHDR :

Для навигации по объектам данных используются следующие макросы:

#define LPCMSGHDR *WSA_CMSG_FIRSTHDR(LPWSAMSG msg);

Возвращает указатель на первый объект данных элемента управления. Возвращает указатель NULL , если в структуре WSAMSG отсутствуют управляющие данные, например, если элемент control является указателем NULL .

#define LPCMSGHDR *WSA_CMSG_NXTHDR(LPWSAMSG msg, LPWSACMSGHDR cmsg);

Возвращает указатель на следующий объект данных элемента управления или значение NULL , если больше нет объектов данных. Если параметр pcmsg имеет значение NULL, возвращается указатель на первый объект данных элемента управления.

#define UCHAR *WSA_CMSG_DATA(LPWSACMSGHDR pcmsg);

Возвращает указатель на первый байт данных (который называется элементом cmsg_data , хотя он не определен в структуре).

#define UINT WSA_CMSG_SPACE(UINT length);

Возвращает общий размер объекта данных элемента управления с учетом объема данных. Используется для выделения правильного объема буферного пространства. Включает заполнение выравнивания.

#define UINT WSA_CMSG_LEN(UINT length);

Возвращает значение в cmsg_len с учетом объема данных. Включает заполнение выравнивания.

Требования

См. также раздел

IPV6_PKTINFO

IP_PKTINFO

SOCKET_ADDRESS

WSABUF

WSARecv

WSARecvFrom

LPFN_WSARECVMSG (WSARecvMsg)

WSASendMsg