WSADATA структура має такий вигляд:
структура WSAData {
nbsp; СЛОВО wVersion;
СЛОВО wHighVersion;
на один знак szDescription [WSADESCRIPTIO&N_LEN + 1];
на один знак szSystemStatus [WSASYSSTATUS_LEN + 1];
Непідписані короткий iMaxSockets;
Непідписані короткий iMaxUdpDg;
Чар ДАЛЕКИЙ * lpVendorInfo;
}
WSADATA структура використовується для зберігання Windows Sockets ініціалізації інформації повертаються на заклик до AfxSocketInit глобальні функції.
Члени
wVersion
Версія Windows Sockets специфікації, що Windows DLL розетки очікує абонента для використання.
wHighVersion
Найвищий версія Windows Sockets специфікації які підтримують цієї DLL (також закодовані як зазначено вище). Зазвичай, це так само, як wVersion.
szDescription
У ASCII рядок в якому Windows DLL розетки копіює опис реалізація Windows Sockets, включаючи Ідентифікація постачальника. Тексту (більше 256 символів у довжину) можуть містити будь-які символи, але продавці застеріг проти контролю в тому числі і форматування символів: швидше за використання, що додаток буде покласти цьому є для відображення її (можливо скорочення) у повідомлення стану.
szSystemStatus
У ASCII рядок в якому Windows DLL розетки копіює відповідні відомості про стан або конфігурації. Windows DLL розетки повинні використовувати це поле, якщо інформація може бути корисним для користувача або допоміжного персоналу; Вона не повинна розглядатися як розширення szDescription поля.
iMaxSockets
Максимальна кількість розеток, який процес потенційно може відкрити. Реалізація Windows Sockets може забезпечити глобальний басейн розетки для розміщення будь-якого процесу; або ж він може виділити за процесом ресурсів для розеток. Числа можна відобразити шлях, в якому було настроєно Windows DLL розетки або мережне програмне забезпечення. Цей номер можна використовувати сирої свідченням того чи реалізація Windows Sockets може використовуватися на додаток застосування письменників. Наприклад, сервер X Windows може перевірити iMaxSockets , коли вперше почав: Якщо це менше 8, додаток буде відображено повідомлення про помилку інструктаж користувач переналаштувати мережне програмне забезпечення. (Це ситуації, в яких може використовуватися szSystemStatus текст). Очевидно, немає ніякої гарантії, що конкретного застосування може фактично виділити iMaxSockets розетки, бо може бути інші Windows Sockets додатків використовується.
iMaxUdpDg
Розмір у байтах найбільших дейтаграм протокол користувацьких дейтаграм (UDP), які можуть бути відправлені або отримали застосунком Windows Sockets. Якщо виконання накладає жодних обмежень, iMaxUdpDg дорівнює нулю. У багатьох реалізаціях Berkeley розеток є непряме обмеження 8192 байт на UDP дейтаграми напряму, (що є роздробленими, якщо це необхідно). Реалізація Windows Sockets може накладати обмеження на основі, наприклад, розміщення фрагмент повторна збірка буфери. Мінімальне значення iMaxUdpDg для сумісних реалізація Windows Sockets складає 512. Зауважте, що незалежно від значення iMaxUdpDg, inadvisable, щоб спробувати надіслати трансляції дейтаграм, яка більше, ніж максимальна передачі одиниці (MTU) для мережі. (Windows API розетки не надає механізм виявити MTU, але вона повинна бути не менше ніж 512 байт).
lpVendorInfo
Далеко вказівник на структуру виробником даних. Визначення цієї структури (якщо додаються) виходить за рамки Windows Sockets специфікації. Докладніше, перегляньте статтю Windows розетки програмування міркувань в документації Win32 SDK.
Примітка У MFC, структура WSADATA повернувся на функцію AfxSocketInit , яка дзвінок у вашому InitInstance функції. Ви можете отримати структуру і зберігати його у програмі, якщо вам потрібно використовувати інформацію з нього пізніше.
Дивіться також AfxSocketInit