WSADATA-Struktur

Die WSADATA-Struktur wird auf Schaufenster Socket-Initialisierungs von Informationen verwendet wird, die durch einen Aufruf der AfxSocketInit globalen Funktion zurückgegeben werden.

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;
};

Parameter

• wVersion
  Die Version von Windows Socket-Spezifikation, dass die Windows-Sockets DLLs den Aufrufer erwartet verwendet werden soll.

• wHighVersion
  Die höchste Version der Windows Socket-Spezifikation, die diese DLLs unterstützt (wie oben ebenfalls codiert).Normalerweise ist dies das wVersion identisch.

• szDescription
  Eine auf NULL endende ASCII-Zeichenfolge, in die die Windows-Sockets DLL Beschreibung der Windows Socket-Implementierung kopiert, einschließlich Anbieter identifikation.Der Text (bis zu 256 Zeichen) kann alle Zeichen enthalten Anbieter jedoch gewarnt werden vor dem Einschließen von Steuerelement- und Formatierung wird: Verwenden Sie die wahrscheinlichste, dass eine Anwendung dies zu platzieren, wird sie abgeschnitten) (möglicherweise in einer Statusmeldung angezeigt werden soll.

• szSystemStatus
  Eine auf NULL endende ASCII-Zeichenfolge, in die die Windows-Sockets DLL relevante Status- oder Konfigurationsinformationen kopiert.Die Windows-Sockets DLL sollten dieses Feld nur dann verwenden, wenn die Informationen werden der Benutzer bzw. die Supportmitarbeiter hilfreich sein können. Der Fehler sollte nicht als eine Erweiterung des Felds szDescription betrachtet werden.

• iMaxSockets
  Die maximale Anzahl von Sockets, die ein einzelner Prozess geöffnet werden kann.Eine Windows Socket-Implementierung kann einen globalen Pool von Sockets für die Zuordnung zu einem beliebigen Prozesses bereitstellen. abwechselnd kann sie pro Prozess für Sockets Ressourcen zuordnen.Die Zahl kann hervorquellen spiegeln die Methode, in der die Windows-Sockets DLL oder die Netzwerk-Software konfiguriert wurden.Anwendungen können werden als diese Zahl grobes Angabe verwenden, ob die Windows Socket-Implementierung von der Anwendung verwendet werden kann.Zum Beispiel kann ein aktivierter Windows-Server X iMaxSockets, wenn Sie das erste Mal gestartet werden: wenn er kleiner als 8 ist, wird die Anwendung eine Fehlermeldung an, die den Benutzer anweist, die Netzwerk-Software neu zu konfigurieren.(Dies ist eine Situation, in der der szSystemStatus Text verwendet wird). Offensichtlich es gibt keine Garantie dafür, dass eine bestimmte Anwendung iMaxSockets Sockets eigentlich zugeordnet werden kann, da sie andere Windows Socket-Anwendungen verwendet werden kann.

• iMaxUdpDg
  Die Größe in Bytes des größten Datagramms UDP (User Datagram Protocol), das von einer Windows Socket-Anwendung gesendet oder empfangen werden.Wenn die Implementierung iMaxUdpDg ist, erzwingt keine Beschränkung (null) ist.In vielen Implementierungen von Berkeley-Sockets, gibt es eine implizite Grenze von 8192 Bytes auf UDP-Datagrammen (ggf. die fragmentiert werden).Eine Windows Socket-Implementierung auferlegen Begrenzung basiert, kann beispielsweise für die Zuordnung von Fragment wiederversammlungs gepuffert werden.Der minimale Wert von iMaxUdpDg für eine kompatible Windows Socket-Implementierung ist 512.Beachten Sie, dass unabhängig vom Wert von iMaxUdpDg, es ist unratsam zu versuchen, ein Übertragungs datagramm, das größer ist als die maximale Übertragungseinheit für das Netzwerk zu senden.(Die Windows-Sockets API stellt keinen Mechanismus, um die maximale Übertragungseinheit zu ermitteln, aber es muss keine weniger als 512 Bytes sein.)

• lpVendorInfo
  Ein weiterhin Zeiger auf einer anbieterspezifischen Datenstruktur.Die Definition dieser Struktur (sofern angegeben) liegt außerhalb des Rahmens der Windows Socket-Spezifikation.

Hinweis
In MFC wird die WSADATA-Struktur mit der AfxSocketInit-Funktion zurückgegeben, die Sie in der InitInstance-Funktion aufrufen.Sie können die Struktur abrufen und sie in Ihrem Programm speichern, wenn Sie Informationen aus ihr höher verwenden müssen.

Anforderungen

Header: winsock2.h

Siehe auch

Referenz

AfxSocketInit

Weitere Ressourcen

Strukturen, Formate, Rückrufe und Meldungszuordnungen