Заголовок winsock2.h

Этот заголовок используется несколькими технологиями. Дополнительные сведения см. в разделе:

• Сетевые драйверы до Windows Vista
• Качество обслуживания (QOS)
• Сокеты Windows 2

winsock2.h содержит следующие программные интерфейсы:

Функции

__WSAFDIsSet Функция __WSAFDIsSet (winsock2.h) указывает, включен ли сокет в набор дескрипторов сокета.
Принять Функция accept разрешает входящую попытку подключения к сокету.
bind Функция bind связывает локальный адрес с сокетом. (функция bind (winsock2.h))
closesocket Функция closesocket закрывает существующий сокет. (функция closesocket (winsock2.h))
connect; Функция connect устанавливает соединение с указанным сокетом.
FD_SET Макрос FD_SET (winsock2.h) используется функциями Windows Sockets (Winsock) и поставщиками услуг для размещения сокетов в наборе.
gethostbyaddr Функция gethostbyaddr извлекает сведения об узле, соответствующие сетевому адресу. (gethostbyaddr больше не рекомендуется, вместо него используйте getnameinfo)
Gethostbyname Функция gethostbyname (winsock2.h) извлекает из базы данных узла сведения об узле, соответствующие имени узла.
gethostname Функция gethostname (winsock2.h) извлекает стандартное имя узла для локального компьютера.
GetHostNameW Функция GetHostNameW получает стандартное имя узла для локального компьютера в виде строки Юникода.
getpeername Функция getpeername (winsock2.h) извлекает адрес однорангового узла, к которому подключен сокет.
getprotobyname Функция getprotobyname (winsock2.h) извлекает сведения о протоколе, соответствующие имени протокола.
getprotobynumber Функция getprotobynumber (winsock2.h) извлекает сведения о протоколе, соответствующие номеру протокола.
getservbyname Функция getservbyname (winsock2.h) извлекает сведения о службе, соответствующие имени службы и протоколу.
getservbyport Функция getservbyport (winsock2.h) извлекает сведения о службе, соответствующие порту и протоколу.
getsockname Функция getsockname (winsock2.h) извлекает локальное имя для указанного дескриптора сокета.
getsockopt Функция getsockopt извлекает текущее значение для параметра сокета, связанного с сокетом любого типа, в любом состоянии, и сохраняет результат в optval.
htond Преобразует значение double из узла в порядок байтов сети TCP/IP (большой байт).
htonf Преобразует значение float из узла в порядок байтов сети TCP/IP (большой байт).
htonl Функция htonl (winsock2.h) преобразует u_long из узла в порядок байтов сети TCP/IP, который является крупным байтом.
htonll Преобразует неподписанный __int64 из узла в порядок байтов сети TCP/IP (большой байт).
htons Функция htons (winsock2.h) преобразует u_short из узла в порядок байтов сети TCP/IP, который является большим порядком байтов.
inet_addr Функция inet_addr (winsock2.h) преобразует строку, содержащую десятичный IPv4-адрес, в правильный адрес для структуры IN_ADDR.
inet_ntoa Функция inet_ntoa (winsock2.h) преобразует интернет-адрес (Ipv4) в строку ASCII в стандартном интернет-десятичном формате.
ioctlsocket Функция ioctlsocket (winsock2.h) управляет режимом ввода-вывода сокета и может использоваться в любом сокете в любом состоянии.
listen Функция listen помещает сокет в состояние, в котором он прослушивает входящее соединение.
ntohd Преобразует неподписанный __int64 из сетевого порядка TCP/IP в порядок байтов узла (который является маленьким байтом в процессорах Intel) и возвращает значение double.
ntohf Преобразует неподписанный __int32 из сетевого порядка TCP/IP в порядок байтов узла (который является маленьким байтом на процессорах Intel) и возвращает значение float.
ntohl Функция ntohl (winsock2.h) преобразует u_long из сетевого порядка TCP/IP в порядок байтов размещения (который является маленьким порядком байтов на процессорах Intel).
ntohll Преобразует неподписанный __int64 из сетевого порядка TCP/IP в порядок байтов узла (который на процессорах Intel имеет небольшой байт).
ntohs Функция ntohs (winsock2.h) преобразует u_short из порядка байтов сети TCP/IP в порядок байтов узла (который является маленьким порядком байтов на процессорах Intel).
ProcessSocketNotifications Связывает набор сокетов с портом завершения и извлекает все уведомления, которые уже находятся в состоянии ожидания на этом порту. После связывания порт завершения получает указанные уведомления о состоянии сокета.
Recv Функция recv (winsock2.h) получает данные из подключенного сокета или ограниченного сокета без подключения.
recvfrom Функция recvfrom получает датаграмму и сохраняет исходный адрес.
select Функция select определяет состояние одного или нескольких сокетов, ожидающих при необходимости выполнения синхронного ввода-вывода.
send Отправляет данные в подключенный сокет. (отправить)
Sendto Функция sendto (winsock2.h) используется для записи исходящих данных в сокет.
setsockopt Функция setsockopt (winsock2.h) задает текущее значение параметра сокета, связанного с сокетом любого типа в любом состоянии.
shutdown Функция завершения работы (winsock2.h) используется на всех типах сокетов для отключения приема, передачи или и того, и другого.
Сокета Функция сокета создает сокет, привязанный к определенному поставщику транспортных услуг.
SocketNotificationRetrieveEvents Эта встроенная вспомогательная функция предоставляется для удобства получения маски событий из OVERLAPPED_ENTRY.
WSAAccept Функция WSAAccept условно принимает соединение на основе возвращаемого значения функции условия, обеспечивает качество спецификаций потока обслуживания и разрешает передачу данных подключения.
WSAAddressToStringA Преобразует все компоненты структуры sockaddr в удобочитаемое строковое представление адреса. (ANSI)
WSAAddressToStringW Преобразует все компоненты структуры sockaddr в удобочитаемое строковое представление адреса. (Юникод)
WSAsyncGetHostByAddr Функция WSAsyncGetHostByAddr (winsock2.h) асинхронно извлекает сведения об узле, соответствующие адресу.
WSAsyncGetHostByName Функция WSAsyncGetHostByName (winsock2.h) асинхронно извлекает сведения об узле, соответствующие имени узла.
WSAsyncGetProtoByName Функция WSAsyncGetProtoByName (winsock2.h) асинхронно извлекает сведения о протоколе, соответствующие имени протокола.
WSAsyncGetProtoByNumber Функция WSAsyncGetProtoByNumber (winsock2.h) асинхронно извлекает сведения о протоколе, соответствующие номеру протокола.
WSAsyncGetServByName Функция WSAsyncGetServByName (winsock2.h) асинхронно извлекает сведения о службе, соответствующие имени и порту службы.
WSAsyncGetServByPort Функция WSAsyncGetServByPort (winsock2.h) асинхронно извлекает сведения о службе, соответствующие порту и протоколу.
WSAsyncSelect Функция WSAAsyncSelect (winsock2.h) запрашивает уведомление Windows на основе сообщений о сетевых событиях для сокета.
WSACancelAsyncRequest Функция WSACancelAsyncRequest (winsock2.h) отменяет неполную асинхронную операцию.
WSACancelBlockingCall Функция WSACancelBlockingCall была удалена в соответствии со спецификацией Windows Sockets 2 версии 2.2.0.
WSACleanup Функция WSACleanup (winsock2.h) прекращает использование WS2_32.dll.
WSACloseEvent Функция WSACloseEvent закрывает открытый дескриптор объекта события.
WSAConnect Функция WSAConnect устанавливает подключение к другому приложению сокета, обменивается данными подключения и задает требуемое качество обслуживания на основе указанной структуры FLOWSPEC.
WSAConnectByList Устанавливает подключение к одной из коллекций возможных конечных точек, представленных набором адресов назначения (имена узлов и порты).
WSAConnectByNameA Устанавливает подключение к указанному узлу и порту. (ANSI)
WSAConnectByNameW Устанавливает подключение к указанному узлу и порту. (Юникод)
WSACreateEvent Функция WSACreateEvent создает новый объект события.
WSADuplicateSocketA Функция WSADuplicateSocket возвращает структуру WSAPROTOCOL_INFO, которую можно использовать для создания нового дескриптора сокета для общего сокета. Функцию WSADuplicateSocket нельзя использовать в сокете с поддержкой QOS. (ANSI)
WSADuplicateSocketW Функция WSADuplicateSocket возвращает структуру WSAPROTOCOL_INFO, которую можно использовать для создания нового дескриптора сокета для общего сокета. Функцию WSADuplicateSocket нельзя использовать в сокете с поддержкой QOS. (Юникод)
WSAEnumNameSpaceProvidersA Функция WSAEnumNameSpaceProviders извлекает сведения о доступных поставщиках пространств имен. (ANSI)
WSAEnumNameSpaceProvidersExA Извлекает сведения о доступных поставщиках пространств имен. (ANSI)
WSAEnumNameSpaceProvidersExW Извлекает сведения о доступных поставщиках пространств имен. (Юникод)
WSAEnumNameSpaceProvidersW Функция WSAEnumNameSpaceProviders извлекает сведения о доступных поставщиках пространств имен. (Юникод)
WSAEnumNetworkEvents Функция WSAEnumNetworkEvents обнаруживает вхождения сетевых событий для указанного сокета, очищает записи внутренних сетевых событий и сбрасывает объекты событий (необязательно).
WSAEnumProtocolsA Функция WSAEnumProtocols извлекает сведения о доступных транспортных протоколах. (ANSI)
WSAEnumProtocolsW Функция WSAEnumProtocols извлекает сведения о доступных транспортных протоколах. (Юникод)
WSAEventSelect Функция WSAEventSelect указывает объект события, связанный с указанным набором FD_XXX сетевых событий.
WSAGetLastError Функция WSAGetLastError (winsock2.h) возвращает состояние ошибки для последней операции Windows Sockets, которая завершилась сбоем.
WSAGetOverlappedResult Функция WSAGetOverlappedResult извлекает результаты перекрывающейся операции с указанным сокетом.
WSAGetQOSByName Функция WSAGetQOSByName инициализирует структуру QOS на основе именованного шаблона или предоставляет буфер для получения перечисления доступных имен шаблонов.
WSAGetServiceClassInfoA Функция WSAGetServiceClassInfo извлекает сведения о классе (схему), относящиеся к указанному классу службы, из указанного поставщика пространства имен. (ANSI)
WSAGetServiceClassInfoW Функция WSAGetServiceClassInfo извлекает сведения о классе (схему), относящиеся к указанному классу службы, из указанного поставщика пространства имен. (Юникод)
WSAGetServiceClassNameByClassIdA Функция WSAGetServiceClassNameByClassId извлекает имя службы, связанной с указанным типом. Это имя является универсальным именем службы, например FTP или SNA, а не именем конкретного экземпляра этой службы. (ANSI)
WSAGetServiceClassNameByClassIdW Функция WSAGetServiceClassNameByClassId извлекает имя службы, связанной с указанным типом. Это имя является универсальным именем службы, например FTP или SNA, а не именем конкретного экземпляра этой службы. (Юникод)
WSAHtonl Функция WSAHtonl преобразует u_long из порядка байтов узла в порядок байтов сети.
WSAHtons Функция WSAHtons преобразует u_short из порядка байтов узла в порядок байтов сети.
WSAInstallServiceClassA Функция WSAInstallServiceClass регистрирует схему класса службы в пространстве имен. (ANSI)
WSAInstallServiceClassW Функция WSAInstallServiceClass регистрирует схему класса службы в пространстве имен. (Юникод)
WSAIoctl Функция WSAIoctl управляет режимом сокета.
WSAIsBlocking Эта функция была удалена в соответствии со спецификацией Windows Sockets 2, редакция 2.2.0. (WSAIsBlocking)
WSAJoinLeaf Функция WSAJoinLeaf объединяет конечный узел в сеанс с несколькими точками, обменивается данными подключения и задает необходимое качество обслуживания на основе указанных структур FLOWSPEC.
WSALookupServiceBeginA Функция WSALookupServiceBegin инициирует клиентский запрос, ограниченный сведениями, содержащимися в структуре WSAQUERYSET. (ANSI)
WSALookupServiceBeginW Функция WSALookupServiceBegin инициирует клиентский запрос, ограниченный сведениями, содержащимися в структуре WSAQUERYSET. (Юникод)
WSALookupServiceEnd Функция WSALookupServiceEnd вызывается для освобождения дескриптора после предыдущих вызовов WSALookupServiceBegin и WSALookupServiceNext.
WSALookupServiceNextA Функция WSALookupServiceNext вызывается после получения дескриптора из предыдущего вызова WSALookupServiceBegin для получения запрошенных сведений о службе. (ANSI)
WSALookupServiceNextW Функция WSALookupServiceNext вызывается после получения дескриптора из предыдущего вызова WSALookupServiceBegin для получения запрошенных сведений о службе. (Юникод)
WSANSPIoctl Позволяет разработчикам выполнять вызовы элементов управления вводом-выводом в зарегистрированное пространство имен.
WSANtohl Функция WSANtohl преобразует u_long из сетевого порядка байтов в порядок размещения байтов.
WSANtohs Функция WSANtohs преобразует u_short из сетевого порядка байтов в порядок байтов узла.
WSAPoll Функция WSAPoll определяет состояние одного или нескольких сокетов.
WSAProviderConfigChange Функция WSAProviderConfigChange уведомляет приложение об изменении конфигурации поставщика.
WSARecv Получает данные из подключенного сокета или ограниченного сокета без подключения. (WSARecv)
WSARecvDisconnect Функция WSARecvDisconnect завершает прием в сокете и извлекает данные об отключении, если сокет ориентирован на подключение.
WSARecvFrom Получает датаграмму и сохраняет исходный адрес.
WSARemoveServiceClass Функция WSARemoveServiceClass окончательно удаляет схему класса службы из реестра.
WSAResetEvent Функция WSAResetEvent сбрасывает состояние указанного объекта события на незначаемое.
WSASend Отправляет данные в подключенный сокет. (WSASend)
WSASendDisconnect Функция WSASendDisconnect инициирует завершение подключения для сокета и отправляет данные об отключении.
WSASendMsg Отправляет данные и необязательные сведения об управлении из подключенных и неподключенных сокетов. Примечание. Эта функция является расширением майкрософт для спецификации Сокетов Windows. .
WSASendTo Отправляет данные в определенное место назначения с помощью перекрывающихся операций ввода-вывода, где это применимо.
WSASetBlockingHook Эта функция была удалена в соответствии со спецификацией Windows Sockets 2, редакция 2.2.0. (WSASetBlockingHook)
WSASetEvent Функция WSASetEvent задает состояние заданного объекта события как сигнальное.
WSASetLastError Функция WSASetLastError (winsock2.h) задает код ошибки, который можно получить с помощью функции WSAGetLastError.
WSASetServiceA Функция WSASetService регистрирует или удаляет из реестра экземпляр службы в одном или нескольких пространствах имен. (ANSI)
WSASetServiceW Функция WSASetService регистрирует или удаляет из реестра экземпляр службы в одном или нескольких пространствах имен. (Юникод)
WSASocketA Функция WSASocket создает сокет, привязанный к конкретному поставщику транспортных услуг. (ANSI)
WSASocketW Функция WSASocket создает сокет, привязанный к конкретному поставщику транспортных услуг. (Юникод)
WSAStartup Функция WSAStartup (winsock2.h) инициирует использование библиотеки DLL Winsock процессом.
WSAStringToAddressA Функция WSAStringToAddress преобразует сетевой адрес в стандартной текстовой форме представления в числовую двоичную форму в структуре sockaddr, которая подходит для передачи в подпрограммы Windows Sockets, которые принимают такую структуру. (ANSI)
WSAStringToAddressW Функция WSAStringToAddress преобразует сетевой адрес в стандартной текстовой форме представления в числовую двоичную форму в структуре sockaddr, которая подходит для передачи в подпрограммы Windows Sockets, которые принимают такую структуру. (Юникод)
WSAUnhookBlockingHook Эта функция была удалена в соответствии со спецификацией Windows Sockets 2, редакция 2.2.0. (WSAUnhookBlockingHook)
WSAWaitForMultipleEvents Возвращает, когда один или все указанные объекты событий находятся в состоянии сигнала, когда истекает время ожидания или выполняется подпрограмма завершения ввода-вывода.

Функции обратного вызова

LPWSAOVERLAPPED_COMPLETION_ROUTINE TBD (LPWSAOVERLAPPED_COMPLETION_ROUTINE)

Структуры

AFPROTOCOLS Структура AFPROTOCOLS предоставляет список протоколов, которым программисты приложений могут ограничивать запросы. Структура AFPROTOCOLS используется только в целях запроса.
BLOB Структура BLOB (winsock2.h), производная от большого двоичного объекта, содержит сведения о блоке данных.
fd_set Структура Fd_set (winsock2.h) используется функциями Сокетов Windows (Winsock) и поставщиками услуг для размещения сокетов в наборе.
HOSTENT Структура HOSTENT (winsock2.h) используется функциями для хранения сведений о данном узле, таких как имя узла, IPv4-адрес и т. д.
in_addr Структура in_addr представляет ip-адрес IPv4.
ЗАДЕРЖИВАТЬСЯ Структура LINGER (winsock2.h) хранит сведения о конкретном сокете, которые указывают, как этот сокет должен вести себя при постановке данных в очередь.
PROTOENT Структура PROTOENT (winsock2.h) содержит имя и номера протоколов, соответствующие заданному имени протокола.
QOS Структура QOS предоставляет средства, с помощью которых приложения с поддержкой QOS могут указывать параметры качества обслуживания для отправленного и полученного трафика в определенном потоке.
SERVENT Структура SERVENT (winsock2.h) используется для хранения или возврата имени и номера службы для заданного имени службы.
SOCK_NOTIFY_REGISTRATION Представляет сведения, предоставляемые функции ProcessSocketNotifications .
TIMEVAL Для указания интервала времени используется структура TIMEVAL (winsock2.h). Он связан с файлом заголовка Time.h распространения программного обеспечения Беркли (BSD).
WSACOMPLETION Задает параметры уведомления о завершении для вызовов элементов управления вводом-выводом, выполненных в зарегистрированное пространство имен.
WSADATA Структура WSADATA (winsock2.h) содержит сведения о реализации сокетов Windows.
WSANAMESPACE_INFOA Содержит все сведения о регистрации для поставщика пространства имен. (WSANAMESPACE_INFOA)
WSANAMESPACE_INFOEXA Содержит все сведения о регистрации для поставщика пространства имен. (WSANAMESPACE_INFOEXA)
WSANAMESPACE_INFOEXW Содержит все сведения о регистрации для поставщика пространства имен. (WSANAMESPACE_INFOEXW)
WSANAMESPACE_INFOW Содержит все сведения о регистрации для поставщика пространства имен. (WSANAMESPACE_INFOW)
WSANETWORKEVENTS Структура WSANETWORKEVENTS используется для хранения внутренней информации сокета о сетевых событиях.
WSANSCLASSINFOA Структура WSANSCLASSINFO предоставляет сведения об отдельных параметрах для определенного пространства имен Сокетов Windows. (ANSI)
WSANSCLASSINFOW Структура WSANSCLASSINFO предоставляет сведения об отдельных параметрах для определенного пространства имен Сокетов Windows. (Юникод)
WSAOVERLAPPED Предоставляет коммуникационную среду между инициацией перекрывающейся операции ввода-вывода и ее последующим завершением.
WSAPOLLFD Хранит сведения о сокете, используемые функцией WSAPoll.
WSAPROTOCOL_INFOA Используется для хранения или получения полных сведений по заданному протоколу. (ANSI)
WSAPROTOCOL_INFOW Используется для хранения или получения полных сведений по заданному протоколу. (Юникод)
WSAPROTOCOLCHAIN Структура WSAPROTOCOLCHAIN содержит список идентификаторов записей каталога, составляющих цепочку протоколов.
WSAQUERYSET2A Предоставляет релевантные сведения о данной службе, включая идентификатор класса службы, имя службы, применимый идентификатор пространства имен и сведения о протоколе, а также набор транспортных адресов, по которым служба прослушивает. (ANSI)
WSAQUERYSET2W Предоставляет релевантные сведения о данной службе, включая идентификатор класса службы, имя службы, применимый идентификатор пространства имен и сведения о протоколе, а также набор транспортных адресов, по которым служба прослушивает. (Юникод)
WSAQUERYSETA Предоставляет релевантные сведения о данной службе, включая идентификатор класса службы, имя службы, применимый идентификатор пространства имен и сведения о протоколе, а также набор транспортных адресов, по которым служба прослушивает. (ANSI)
WSAQUERYSETW Предоставляет релевантные сведения о данной службе, включая идентификатор класса службы, имя службы, применимый идентификатор пространства имен и сведения о протоколе, а также набор транспортных адресов, по которым служба прослушивает. (Юникод)
WSASERVICECLASSINFOA Структура WSASERVICECLASSINFO содержит сведения о указанном классе службы. Для каждого класса служб в Windows Sockets 2 существует одна структура WSASERVICECLASSINFO. (ANSI)
WSASERVICECLASSINFOW Структура WSASERVICECLASSINFO содержит сведения о указанном классе службы. Для каждого класса служб в Windows Sockets 2 существует одна структура WSASERVICECLASSINFO. (Юникод)
WSAVERSION Структура WSAVERSION обеспечивает сравнение версий в сокетах Windows.

Перечисления

WSAECOMPARATOR Тип перечисления Windows Sockets WSAECOMPARATOR используется для семантики сравнения версий в сокетах Windows 2.