WSADATA – struktura
WSADATA Struktura se používá k ukládání informací inicializace rozhraní Windows Sockets vrácené volání AfxSocketInit globální funkce.
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
Verze specifikace rozhraní Windows Sockets, že Knihovnu Windows Sockets očekává, že volající použít.wHighVersion
Nejvyšší verze specifikace rozhraní Windows Sockets, podporující tuto knihovnu DLL (také kódovány jako výše).Obvykle to je stejné jako wVersion.szDescription
Zakončený ASCII řetězec do kterého Knihovnu Windows Sockets zkopíruje popis implementace rozhraní Windows Sockets, včetně identifikace dodavatele.(Až 256 znaků) text může obsahovat libovolné znaky, ale dodavatelé jsou cautioned proti včetně kontroly a formátování znaků: nejpravděpodobnější použití, které aplikace budou klást to je zobrazení (případně zkrácen) ve zprávě stav.szSystemStatus
Zakončený ASCII řetězec do kterého Knihovnu Windows Sockets zkopíruje příslušné informace o stavu nebo konfigurace.Knihovnu Windows Sockets má toto pole použít pouze v případě, že informace mohou být užitečné pro uživatele nebo podporu zaměstnanců; by neměla být považována rozšíření szDescription pole.iMaxSockets
Maximální počet soketů, které mohou potenciálně otevřít jeden proces.Implementace rozhraní Windows Sockets mohou poskytnout globální fond soketů pro přidělení k libovolnému procesu; případně jej můžete přidělením zdrojů na proces sokety.Číslo lze dobře odrážejí způsob, ve kterém byl nakonfigurován Knihovnu Windows Sockets nebo síťový software.Autoři aplikace můžete použít toto číslo jako hrubý označení, zda je implementace rozhraní Windows Sockets použitelné aplikace.Například může zkontrolovat serveru X Windows iMaxSockets při prvním spuštění: Pokud je menší než 8, aplikace zobrazí chybová zpráva informuje uživatele o znovu nakonfigurovat síťový software. (Jedná se o situaci, ve které szSystemStatus může být text použit.) Zjevně není zaručeno, že určité aplikace může být ve skutečnosti iMaxSockets sockets, protože mohou být další aplikací rozhraní Windows Sockets.iMaxUdpDg
Velikost v bajtech největšího datagram protokolu UDP (User Datagram), který může odeslané a přijaté aplikace Windows Sockets.Pokud provádění ukládá bez omezení iMaxUdpDg je nula.V mnoha implementacích Berkeley soketů je implicitní maximálně 8192 bajtů datagramy UDP (které jsou fragmentovány, pokud je to nutné).Implementace rozhraní Windows Sockets mohou omezit, například na základě přidělení vyrovnávací paměti pro nové sestavení fragmentu.Minimální hodnota iMaxUdpDg implementace standardu Windows Sockets je 512.Všimněte si, že bez ohledu na hodnotu iMaxUdpDg, není vhodné pokus odeslat vysílání datagram, který je větší než největší přenosovou jednotku (MTU) sítě. (Rozhraní Windows Sockets API neposkytuje mechanismus pro zjišťování jednotky MTU, ale musí být nižší než 512 bajtů.)lpVendorInfo
Vzdálenější ukazatel na strukturu dat specifických pro dodavatele.Definice této struktury (Pokud je zadán) je nad rámec specifikace rozhraní Windows Sockets.
[!POZNÁMKA]
V knihovně MFC WSADATA struktura je vrácen AfxSocketInit funkce volání ve vaší InitInstance funkce.Můžete načíst strukturu a ukládat v aplikaci, pokud je nutné použít informace z něj později.
Požadavky
Hlavička: winsock2.h