Sdílet prostřednictvím


Struktura WSADATA

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 očekává, že Knihovnu Windows Sockets volající použít.

  • wHighVersion
    Nejvyšší verze specifikace rozhraní Windows Sockets podporující tuto knihovnu DLL (také kódovány jako výše).Obvykle je stejné jako wVersion.

  • szDescription
    Zakončený řetězec ASCII do kterého Knihovnu Windows Sockets zkopíruje popis implementace rozhraní Windows Sockets, včetně identifikace prodejce.Text (až 256 znaků) může obsahovat libovolné znaky, ale jsou dodavatelé cautioned proti včetně řízení a formátování znaků: je nejpravděpodobnější použití, které aplikace budou umístit tento zobrazení (případně zkráceny) ve zprávě o stavu.

  • szSystemStatus
    Zakončený řetězec ASCII do kterého Knihovnu Windows Sockets zkopíruje příslušné informace o stavu nebo konfigurace.Knihovnu Windows Sockets by toto pole použít pouze v případě, že informace může být užitečná pro uživatele nebo podporovat pracovníky; to není třeba považovat rozšíření szDescription pole.

  • iMaxSockets
    Maximální počet soketů, které mohou potenciálně otevřít jeden proces.Implementace rozhraní Windows Sockets mohou poskytovat globální fond soketů pro přidělení procesu; také ji lze přidělovat zdroje proces pro sokety.Číslo můžete také zrcadlit způsobem, v němž byl nakonfigurován Knihovnu Windows Sockets nebo síťový software.Toto číslo můžete použít jako hrubý označení, zda je implementace rozhraní Windows Sockets použitelné aplikace aplikací.Například může zkontrolovat serveru X Windows iMaxSockets při prvním spuštění: Pokud je menší než 8, aplikace by se zobrazila chybová zpráva odebíraném uživatel znovu nakonfigurovat síťový software.(Toto je situace, ve které szSystemStatus text může být použit.) Zjevně není zaručeno, že skutečně přidělit určité aplikace iMaxSockets sockets mohou být jiné aplikace Windows Sockets používá.

  • iMaxUdpDg
    Velikost v bajtech největší datagram protokolu UDP (User Datagram), který obdržel aplikace Windows Sockets nebo.Pokud provádění ukládá bez omezení iMaxUdpDg je nula.V mnoha implementacích Berkeley sockets je implicitní limit 8192 bajtů na datagramy UDP (které jsou fragmentovány, pokud je to nutné).Implementace rozhraní Windows Sockets mohou stanovit omezení, například na základě přidělení vyrovnávací paměti pro nové sestavení fragmentu.Minimální hodnota iMaxUdpDg je 512 implementace standardu Windows Sockets.Všimněte si, že bez ohledu na hodnotu iMaxUdpDg, je vhodné odeslat datagram vysílání, který je větší než největší přenosovou jednotku (MTU) sítě.(Rozhraní Windows Sockets API neposkytuje mechanismus zjišťování jednotky MTU, ale musí být méně než 512 bajtů.)

  • lpVendorInfo
    Pokud ukazatel na strukturu dat specifických pro dodavatele.Definice struktury (je-li zadán) je nad rámec specifikace rozhraní Windows Sockets.

[!POZNÁMKA]

V MFC WSADATA struktury vrátil AfxSocketInit funkce volání v vaše InitInstance funkce.Můžete načíst strukturu a ukládat v programu, pokud potřebujete použít informace z ji později.

Požadavky

Záhlaví: winsock2.h

Viz také

Referenční dokumentace

AfxSocketInit

Další zdroje

Struktury, styly, zpětná volání a zprávy mapy