Struktura WSADATA
WSADATA Struktury jest używany do przechowywania Windows Sockets inicjalizacji informacji zwracanych przez wywołanie 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, że biblioteki DLL Windows Sockets oczekuje, że obiekt wywołujący korzystać.wHighVersion
Najwyższą wersję specyfikacji Windows Sockets, który może obsługiwać tej biblioteki DLL (również zakodowana jak wyżej).Normalnie, jest taka sama, jak wVersion.szDescription
Ciąg ASCII zakończony znakiem null, do którego biblioteki DLL Windows Sockets kopiuje opis implementacja Windows Sockets, łącznie z identyfikacją dostawcy.Tekst (do 256 znaków) mogą zawierać dowolne znaki, ale dostawców są ostrzeżenia przed tym kontroli i formatowanie znaków: najbardziej prawdopodobnym sposobem wykorzystania, że aplikacja położy to jest do wyświetlenia go (ewentualnie obcięty) w komunikatu o stanie.szSystemStatus
Ciąg ASCII zakończony znakiem null, do którego biblioteki DLL Windows Sockets kopiuje odpowiednie informacje stanu lub konfiguracji.Biblioteki DLL Windows Sockets należy to pole jest używane tylko wtedy, gdy informacje mogą być przydatne dla użytkownika lub obsługuje personelu; należy nie uznawane za przedłużenie szDescription pole.iMaxSockets
Maksymalną liczbę gniazd, które potencjalnie mogą otwierać pojedynczego procesu.Implementacja Windows Sockets zapewnić globalnej puli gniazd do alokacji do dowolnego procesu; na przemian to przydzielanie zasobów na proces dla gniazd.Numer może również odzwierciedlać sposób, w którym skonfigurowano biblioteki DLL Windows Sockets lub oprogramowanie sieciowe.Autorzy aplikacji tej liczby można określić jako oznaczenie surowych czy implementacja Windows Sockets może być używany w aplikacji.Na przykład, może sprawdzić serwer X Windows iMaxSockets po pierwszym uruchomieniu: Jeśli jest mniejsze niż 8, aplikacja będzie wyświetlony komunikat o błędzie użytkownik ponownie skonfigurować oprogramowanie sieciowe. (Jest to sytuacja, w której szSystemStatus tekst może być używany.) Oczywiście nie ma żadnej gwarancji, że faktycznie można przydzielić określonej aplikacji iMaxSockets gniazd, ponieważ mogą być używane inne aplikacje Windows Sockets.iMaxUdpDg
Rozmiar w bajtach największych datagram Protokół datagramów użytkownika (UDP), które mogą być wysyłane i odbierane przez aplikację usługi Windows Sockets.Jeśli wdrożenie nakłada limitu, iMaxUdpDg wynosi zero.W wielu implementacjach gniazdek istnieje niejawna wynoszący 8192 bajty na datagramów UDP (które są pofragmentowane, jeśli to konieczne).Implementacja Windows Sockets mogą nałożyć ograniczenie, na przykład na podstawie alokacji buforów ponownego asemblowania fragmentu.Minimalna wartość iMaxUdpDg zgodny z usługi Windows Sockets implementacja jest 512.Należy zauważyć, że niezależnie od wartości iMaxUdpDg, nie zaleca się próba wysłania datagramu emisji, która jest większa od maksymalnej jednostki transmisji (MTU) dla sieci. (Interfejsu API Windows Sockets nie zapewnia mechanizm wykrywania wielkości MTU, ale musi być nie mniejsza niż 512 bajtów).lpVendorInfo
Daleko wskaźnika do struktury danych specyficznych dla dostawcy.Definicja ta struktura (jeśli jest podany) wykracza poza zakres specyfikacji usługi Windows Sockets.
[!UWAGA]
W MFC WSADATA struktury jest zwracany przez AfxSocketInit funkcja, która wywołania w swojej InitInstance funkcji.Można uzyskać struktury i umieszczenie go w programie, jeśli konieczne jest użycie informacji z niego później.
Wymagania
Nagłówek: winsock2.h