Функция обратного вызова LPWSPSOCKET (ws2spi.h)

Функция LPWSPSocket создает сокет. Сведения о роли , которую играет LPWSPSocket в создании общего сокета, см. в разделе Общие сокеты и Общие сокеты в SPI.

Синтаксис

LPWSPSOCKET Lpwspsocket;

SOCKET Lpwspsocket(
  [in]  int af,
  [in]  int type,
  [in]  int protocol,
  [in]  LPWSAPROTOCOL_INFOW lpProtocolInfo,
  [in]  GROUP g,
        DWORD dwFlags,
  [out] LPINT lpErrno
)
{...}

Параметры

[in] af

Спецификация семейства адресов.

[in] type

Спецификация типа для нового сокета.

[in] protocol

Протокол, используемый с сокетом, характерным для указанного семейства адресов.

[in] lpProtocolInfo

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

[in] g

Зарезервировано.

dwFlags

Спецификация атрибута сокета.

[out] lpErrno

Указатель на код ошибки.

Возвращаемое значение

Если ошибка не возникает, LPWSPSocket возвращает дескриптор, ссылающийся на новый сокет. В противном случае возвращается значение INVALID_SOCKET, а в lpErrno доступен определенный код ошибки.

Комментарии

Функция LPWSPSocket приводит к выделению дескриптора сокета и всех связанных ресурсов. По умолчанию созданный сокет не будет иметь перекрываемый атрибут. Поставщики сокетов Windows рекомендуется реализовать как устанавливаемые файловые системы Windows и предоставлять системные дескрипторы файлов в качестве дескрипторов сокетов. Эти поставщики должны вызвать WPUModifyIFSHandle перед возвратом из этой функции. Для поставщиков сокетов Windows, не относящихся к системе, необходимо использовать WPUCreateSocketHandle для получения уникального дескриптора сокета из Ws2_32.dll перед возвратом из этой функции. См.
Выделение дескриптора для получения дополнительных сведений.

Значения af, type и protocol предоставляются приложением в соответствующем сокете функций API или WSASocket. Поставщик услуг может игнорировать или обращать внимание на любые или все эти значения в соответствии с конкретным протоколом. Однако поставщик должен быть готов принять нулевое значение для af и type, так как Ws2_32.dll считает эти значения подстановочными знаками. Кроме того, необходимо принять значение константы манифеста FROM_PROTOCOL_INFO для любого из af, type и protocol. Это значение указывает, что приложение Windows Sockets 2 должно использовать соответствующие значения из структуры WSAProtocol_Info (iAddressFamily, iSocketType, iProtocol).

Параметр dwFlags можно использовать для указания атрибутов сокета с помощью побитового оператора OR с любым из следующих флагов.

Сокеты, ориентированные на подключение, такие как SOCK_STREAM обеспечивают полнодуплексные подключения и должны находиться в подключенном состоянии перед отправкой или получением данных. Подключение к другому сокету создается с помощью вызова LPWSPConnect . После подключения данные можно передавать с помощью вызовов LPWSPSend и LPWSPRecv . После завершения сеанса необходимо выполнить LPWSPCloseSocket .

Протоколы связи, используемые для реализации надежного, ориентированного на подключение сокета, гарантируют, что данные не будут потеряны и не дублируются. Если данные, для которых одноранговый протокол имеет буферное пространство, не могут быть успешно переданы в течение разумного промежутка времени, соединение считается нарушенным, и последующие вызовы завершатся ошибкой с кодом ошибки WSAETIMEDOUT.

Сокеты без подключения, ориентированные на сообщения, позволяют отправлять и получать датаграммы в произвольные одноранговые узлы и из нее с помощью LPWSPSendTo и LPWSPRecvFrom. Если такой сокет подключен с помощью LPWSPConnect к определенному одноранговой сети, датаграммы можно отправлять на этот одноранговый узел с помощью LPWSPSend и получать от этого однорангового узла (только) с помощью LPWSPRecv.

Поддержка сокетов с типом SOCK RAW не требуется, но поставщикам услуг рекомендуется поддерживать необработанные сокеты, когда это имеет смысл.

Многоуровневый поставщик услуг предоставляет реализацию этой функции, но он также является клиентом этой функции, если и когда он вызывает LPWSPSocket следующего уровня в цепочке протоколов. Некоторые особые рекомендации относятся к параметру lpProtocolInfo этой функции, так как он распространяется по уровням цепочки протоколов.

Если следующий слой в цепочке протоколов является другим слоем, то при вызове LPWSPSocket следующего слоя этот слой должен передать следующему слою lpProtocolInfo , который ссылается на ту же неизмененную WSAProtocol_Info структуру с той же неизмененную информацию о цепочке. Однако если следующий уровень является базовым протоколом (т. е. последним элементом в цепочке), этот слой выполняет подстановку при вызове LPWSPSocket базового поставщика. В этом случае на структуру WSAPROTOCOL_INFO базового поставщика следует ссылаться с помощью параметра lpProtocolInfo .

Одним из важнейших преимуществ этой политики является то, что базовые поставщики услуг не должны знать о цепочках протоколов.

Эта же политика распространения применяется при распространении структуры WSAProtocol_Info с помощью многоуровневой последовательности других функций, таких как LPWSPAddressToString, LPWSPDuplicateSocket, WSPStartup или LPWSPStringToAddress.

Требования

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

• WPUCreateSocketHandle
• LPWSPAccept
• LPWSPBind
• LPWSPConnect
• LPWSPCloseSocket
• LPWSPGetSockName
• LPWSPGetSockOpt
• LPWSPIoctl
• LPWSPListen
• LPWSPRecv
• LPWSPRecvFrom
• LPWSPSend
• LPWSPSendTo
• LPWSPSetSockOpt
• LPWSPShutdown