Struktura WSADATA
WSADATA Struktury jest używany do przechowywania informacji o zainicjowanie Windows Sockets zwrócony przez wywołanie do AfxSocketInit funkcja globalna.
struct WSAData {
WORD wVersion;
WORD wHighVersion;
char szDescription[WSADESCRIPTION_LEN+1];
char szSystemStatus[WSASYSSTATUS_LEN+1];
unsigned short iMaxSockets;
unsigned short iMaxUdpDg;
char FAR * lpVendorInfo;
};
Parametry
wVersion
Wersja specyfikacji Windows Sockets oczekuje, że biblioteki DLL Windows Sockets wywołującego, aby użyć.wHighVersion
Najwyższy wersja specyfikacji Windows Sockets, który może obsługiwać tej biblioteki DLL (również zakodowana jak wyżej).Zwykle jest to taki sam, jak wVersion.szDescription
Ciąg zakończony zerem ASCII do której biblioteki DLL Windows Sockets kopiuje opis implementacja Windows Sockets, włączając identyfikację dostawcy.Tekst (do 256 znaków długości) może zawierać dowolne znaki, ale dostawców są cautioned przeciwko tym kontroli i formatowanie znaków: najprawdopodobniej korzystania, który aplikacja wprowadzi się to do jest do wyświetlania go (ewentualnie obcięte) komunikat stanu.szSystemStatus
Ciąg zakończony zerem ASCII do której biblioteki DLL Windows Sockets kopiuje istotne informacje dotyczące stanu lub konfiguracji.Biblioteki DLL Windows Sockets, należy użyć tego pola tylko wtedy, gdy informacje mogą być przydatne dla użytkownika lub personelu; nie powinien być traktowany jako rozszerzenie szDescription pola.iMaxSockets
Maksymalną liczbę gniazd, które potencjalnie mogą być otwarte pojedynczego procesu.Implementacja Windows Sockets mogą zapewnić globalnej puli gniazd dla alokacji do dowolnego procesu; go ewentualnie przydzielić zasobów na proces, dla gniazd.Liczby można również odzwierciedlają sposób, w którym zostało skonfigurowane biblioteki DLL Windows Sockets lub oprogramowanie sieciowe.Autorzy aplikacji można użyć ten numer jako oznaczenie surowych czy implementacja Windows Sockets jest używany przez aplikację.Na przykład może sprawdzić serwer X Windows iMaxSockets podczas pierwszego uruchomienia: Jeżeli jest mniej niż 8, aplikacja będzie wyświetlony komunikat o błędzie instrukcją użytkownika ponownie skonfigurować oprogramowanie sieciowe.(Jest to sytuacja, w której szSystemStatus tekst może być używana.) Oczywiście nie ma żadnej gwarancji, że faktycznie alokowania określonej aplikacji iMaxSockets gniazd, ponieważ mogą być używane inne aplikacje Windows Sockets.iMaxUdpDg
Rozmiar w bajtach największy datagram protokołu UDP (User Datagram), który wysyłane lub odbierane przez aplikacji Windows Sockets.Jeśli wykonania nakłada się żadnego limitu iMaxUdpDg jest równa zero.W wielu implementacjach gniazd Berkeley istnieje niejawna limitu 8192 bajtów datagramów UDP (które są pofragmentowane, jeśli to konieczne).Implementacja Windows Sockets mogą nałożyć limit, na przykład, na podstawie alokacji buforów ponownego asemblowania fragmentu.Minimalna wartość iMaxUdpDg zgodny z Windows Sockets implementacja jest 512.Należy zauważyć, że niezależnie od wartości iMaxUdpDg, nie jest wskazane próba wysłania datagram emisji, który jest większy niż jednostki transmisji (MTU), maksymalna, dla sieci.(Windows Sockets API nie zapewnia mechanizm do odkrywania MTU, ale musi być nie mniejsza niż 512 bajtów).lpVendorInfo
Far wskaźnika do struktury danych specyficznych dla dostawcy.Definicja ta struktura (Jeśli dostarczone) wykracza poza zakres specyfikacji Windows Sockets.
[!UWAGA]
W MFC WSADATA struktury jest zwracany przez AfxSocketInit funkcji wywołania w sieci InitInstance funkcji.Można pobrać struktury i przechowywać w programie, jeśli konieczne jest użycie informacji z niego później.
Wymagania
Nagłówek: winsock2.h