La estructura WSADATA tiene el siguiente formulario:
struct {WSAData
nbsp; WORD wVersion;
WORD wHighVersion;
Char szDescription [WSADESCRIPTIO&N_LEN + 1];
Char szSystemStatus [WSASYSSTATUS_LEN + 1];
unsigned short iMaxSockets;
unsigned short iMaxUdpDg;
Char FAR * lpVendorInfo;
}
La estructura WSADATA se utiliza para almacenar la información de inicialización de Windows Sockets devuelta por una llamada a la función global AfxSocketInit.
Miembros
wVersion
La versión de la especificación de Windows Sockets que la DLL de Windows Sockets espera utilizar el llamador.
wHighVersion
La versión más alta de la especificación de Windows Sockets que puede soportar esta DLL (también codificada como arriba). Normalmente esto es lo mismo que wVersion.
szDescription
Una cadena terminada en nulo ASCII en el que la DLL de Windows Sockets copia una descripción de la aplicación de Windows Sockets, incluida la identificación del proveedor. El texto (hasta 256 caracteres de longitud) puede contener cualquier carácter, pero los proveedores son advierte incluyendo el control y el formato de caracteres: es el uso más probable que una aplicación se ponga a mostrarlo (posiblemente truncado) en un mensaje de Estado.
szSystemStatus
Una cadena terminada en nulo ASCII que la DLL de Windows Sockets copia información de configuración o Estado pertinente. La DLL de Windows Sockets debe usar este campo sólo si la información puede ser útil para el usuario o apoyo personal; no debe considerarse como una extensión del campo de szDescription.
iMaxSockets
El número máximo de sockets que potencialmente puede abrir un solo proceso. Una aplicación de Windows Sockets puede proporcionar una agrupación mundial de sockets para asignación a cualquier proceso; también pueden asignar recursos por proceso para sockets. El número bien puede reflejar la forma en que se configuró la DLL de Windows Sockets o el software de red. Escritores de aplicación pueden utilizar este número como una indicación de si la aplicación de Windows Sockets es utilizable por la aplicación de crudo. Por ejemplo, un servidor X Windows puede comprobar iMaxSockets cuando inició por primera vez: si es inferior a 8, la aplicación mostrará un mensaje de error indicando al usuario a configurar el software de red. (Esta es una situación que podría usarse el texto de szSystemStatus ). Obviamente no hay ninguna garantía de que una determinada aplicación realmente puede asignar iMaxSockets zócalos, ya que puede haber otras aplicaciones de Windows Sockets en uso.
iMaxUdpDg
El tamaño en bytes del datagrama más grande de protocolo de datagrama de usuario (UDP) que pueden ser enviados o recibidos por una aplicación de Windows Sockets. Si la aplicación no impone límites, iMaxUdpDg es cero. En muchas implementaciones de sockets Berkeley, hay un límite implícito de 8192 bytes en datagramas UDP (que están fragmentados si es necesario). Una aplicación de Windows Sockets puede imponer un límite basado, por ejemplo, la asignación de los búferes de reensamblaje del fragmento. El valor mínimo de iMaxUdpDg para una implementación compatible de Windows Sockets es 512. Tenga en cuenta que, independientemente del valor de la iMaxUdpDg, es desaconsejable intentar enviar un datagrama de difusión que es mayor que la unidad de transmisión máxima (MTU) de la red. (La API de Windows Sockets no proporcionan un mecanismo para descubrir la MTU, pero debe ser no menos de 512 bytes).
lpVendorInfo
Un lejano puntero a una estructura de datos específicos del proveedor. La definición de esta estructura (si se proporciona) está fuera del alcance de la especificación de Windows Sockets. Para obtener más información, consulte Consideraciones de programación de Windows Sockets en la documentación del SDK de Win32.
&Notanbsp; En MFC, la estructura WSADATA es devuelto por la función AfxSocketInit , que se llama en su InitInstance función. Puede recuperar la estructura y almacenar en su programa si necesita utilizar la información de más tarde.
Vea tambié&nnbsp;AfxSocketInit