структура WSAPROTOCOL_INFOA (winsock2.h)

Структура WSAPROTOCOL_INFO используется для хранения или получения полных сведений по заданному протоколу.

Синтаксис

typedef struct _WSAPROTOCOL_INFOA {
  DWORD            dwServiceFlags1;
  DWORD            dwServiceFlags2;
  DWORD            dwServiceFlags3;
  DWORD            dwServiceFlags4;
  DWORD            dwProviderFlags;
  GUID             ProviderId;
  DWORD            dwCatalogEntryId;
  WSAPROTOCOLCHAIN ProtocolChain;
  int              iVersion;
  int              iAddressFamily;
  int              iMaxSockAddr;
  int              iMinSockAddr;
  int              iSocketType;
  int              iProtocol;
  int              iProtocolMaxOffset;
  int              iNetworkByteOrder;
  int              iSecurityScheme;
  DWORD            dwMessageSize;
  DWORD            dwProviderReserved;
  CHAR             szProtocol[WSAPROTOCOL_LEN + 1];
} WSAPROTOCOL_INFOA, *LPWSAPROTOCOL_INFOA;

Члены

dwServiceFlags1

Тип: DWORD

Битовая маска, описывающая службы, предоставляемые протоколом. Возможные значения для этого элемента определяются в файле заголовка Winsock2.h .

Возможны следующие значения.

dwServiceFlags2

Тип: DWORD

Зарезервировано для дополнительных определений атрибутов протокола.

dwServiceFlags3

Тип: DWORD

Зарезервировано для дополнительных определений атрибутов протокола.

dwServiceFlags4

Тип: DWORD

Зарезервировано для дополнительных определений атрибутов протокола.

dwProviderFlags

Тип: DWORD

Набор флагов, содержащий сведения о том, как этот протокол представлен в каталоге Winsock. Возможные значения для этого элемента определяются в файле заголовка Winsock2.h .

Возможны следующие значения флагов.

ProviderId

Тип: GUID

Глобальный уникальный идентификатор (GUID), назначенный поставщику услуг. Это значение полезно для тех случаев, когда несколько поставщиков услуг могут реализовать определенный протокол. Приложение может использовать член ProviderId для различения поставщиков, которые в противном случае могли бы быть неотличимыми.

dwCatalogEntryId

Тип: DWORD

Уникальный идентификатор, присвоенный WS2_32.DLL для каждой структуры WSAPROTOCOL_INFO .

ProtocolChain

Тип: WSAPROTOCOLCHAIN

Структура WSAPROTOCOLCHAIN , связанная с протоколом. Если длина цепочки равна 0, эта запись WSAPROTOCOL_INFO представляет многоуровневый протокол, в котором в качестве верхнего и нижнего краев используется spi Windows Sockets 2. Если длина цепочки равна 1, эта запись представляет базовый протокол, идентификатор записи каталога которого находится в элементе dwCatalogEntryIdструктуры WSAPROTOCOL_INFO . Если длина цепочки больше 1, эта запись представляет цепочку протоколов, состоящую из одного или нескольких многоуровневых протоколов поверх базового протокола. Соответствующие идентификаторы записи каталога находятся в массиве ProtocolChain.ChainEntries, начиная с многоуровневого протокола в верхней части (нулевого элемента в массиве ProtocolChain.ChainEntries) и заканчивая базовым протоколом. Дополнительные сведения о цепочках протоколов см. в спецификации интерфейса поставщика служб Windows Sockets 2.

iVersion

Тип: int

Идентификатор версии протокола.

iAddressFamily

Тип: int

Значение, передаваемое в качестве параметра семейства адресов в сокет или функцию WSASocket , чтобы открыть сокет для этого протокола. Это значение также однозначно определяет структуру адреса протокола для sockaddr, используемого протоколом.

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

В версиях пакета SDK платформы для Windows Server 2003 и более ранних версий возможные значения для семейства адресов определяются в файле заголовка Winsock2.h .

В настоящее время поддерживаются значения AF_INET или AF_INET6, которые являются форматами семейств адресов Интернета для IPv4 и IPv6. Другие варианты семейства адресов (например, AF_NETBIOS для использования с NetBIOS) поддерживаются, если установлен поставщик службы Windows Sockets для семейства адресов. Обратите внимание, что значения для семейства адресов AF_ и констант семейства PF_ протоколов идентичны (например, AF_INET и PF_INET), поэтому можно использовать либо константу.

В таблице ниже перечислены распространенные значения для семейства адресов, хотя возможны и многие другие значения.

iMaxSockAddr

Тип: int

Максимальная длина адреса в байтах.

iMinSockAddr

Тип: int

Минимальная длина адреса в байтах.

iSocketType

Тип: int

Значение, передаваемое в качестве параметра типа сокета функции сокета или WSASocket , чтобы открыть сокет для этого протокола. Возможные значения для типа сокета определяются в файле заголовка Winsock2.h .

В следующей таблице перечислены возможные значения элемента iSocketType , поддерживаемого для Windows Sockets 2:

iProtocol

Тип: int

Значение , передаваемое в качестве параметра протокола в сокет или функцию WSASocket , чтобы открыть сокет для этого протокола. Возможные параметры для элемента iProtocol относятся к указанному семейству адресов и типу сокета.

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

В версиях пакета SDK платформы для Windows Server 2003 и более ранних версий возможные значения элемента iProtocol определяются в файлах заголовков Winsock2.h и Wsrm.h .

В таблице ниже перечислены распространенные значения для iProtocol , хотя возможны и многие другие значения.

iProtocolMaxOffset

Тип: int

Максимальное значение, которое может быть добавлено в iProtocol при указании значения параметра протокола в сокет или функцию WSASocket . Не все протоколы допускают диапазон значений. В этом случае значение iProtocolMaxOffset равно нулю.

iNetworkByteOrder

Тип: int

В настоящее время эти значения являются константами манифеста (BIGENDIAN и LITTLEENDIAN), которые указывают на большой эндиан или маленький эндиан со значениями 0 и 1 соответственно.

iSecurityScheme

Тип: int

Тип используемой схемы безопасности (при наличии). Значение SECURITY_PROTOCOL_NONE (0) используется для протоколов, которые не включают положения безопасности.

dwMessageSize

Тип: DWORD

Максимальный размер сообщения (в байтах), поддерживаемый протоколом. Это максимальный размер, который можно отправить из любого локального интерфейса узла. Для протоколов, которые не поддерживают обрамления сообщений, фактическое максимальное значение, которое можно отправить на заданный адрес, может быть меньше. Стандартная подготовка для определения максимального размера входящего сообщения отсутствует. Определены следующие специальные значения.

dwProviderReserved

Тип: DWORD

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

szProtocol[WSAPROTOCOL_LEN + 1]

Тип: TCHAR[WSAPROTOCOL_LEN+1]

Массив символов, содержащий понятное имя, определяющее протокол, например MSAFD Tcpip [UDP/IP]. Максимально допустимое количество символов — WSAPROTOCOL_LEN, которое определяется как 255.

Комментарии

Требования

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

WSAEnumProtocols

WSAPROTOCOLCHAIN

WSAPROTOCOL_INFOW

WSASend

WSASendTo

WSASocket

WSCInstallProvider

WSCInstallProvider64_32

WSCUpdateProvider

WSCUpdateProvider32

getsockopt

Сокета