A WSADATA estrutura tem a seguinte forma:
struct {WSAData
nbsp; PALAVRA wVersion;
PALAVRA wHighVersion;
Char szDescription [WSADESCRIPTIO&N_LEN + 1];
Char szSystemStatus [WSASYSSTATUS_LEN + 1];
não assinado curto iMaxSockets;
não assinado curto iMaxUdpDg;
Char extremo * lpVendorInfo;
}
A estrutura WSADATA é usada para armazenar informações de inicialização do Windows Sockets retornadas por uma chamar a função global AfxSocketInit.
Membros
wVersion
A versão da especificação do Windows Sockets que a DLL de Sockets do Windows espera que o chamador para use.
wHighVersion
A versão mais recente da especificação do Windows Sockets que essa DLL pode suporte (também codificada como acima). Normalmente isso é o mesmo que wVersion.
szDescription
Um caracteres null-terminated ASCII no qual a DLL de Sockets do Windows copia uma descrição da implementação do Windows Sockets, incluindo identificação de fornecedor. O texto (até 256 caracteres de comprimento) pode conter quaisquer caracteres, mas fornecedores são advertidos contra incluindo Controlarar e a formatação de caracteres: o uso mais provável que um aplicativo colocará isso para é exibi-lo (possivelmente truncado) em uma mensagem de status.
szSystemStatus
Um caracteres null-terminated ASCII no qual a DLL de Sockets do Windows copia informações relevantes status ou configuração. A DLL de Sockets do Windows deve usar este campo somente se as informações podem ser úteis para o usuário ou suporte pessoal; não deve ser considerado como uma extensão do campo szDescription.
iMaxSockets
O número máximo de soquetes que potencialmente pode abrir um único processo. Uma implementação de Windows Sockets pode fornecer um conjunto global de soquetes para alocação a qualquer processo; Alternativamente ele pode alocar recursos por processo para soquetes. O número também pode refletir a maneira na qual a DLL de Sockets do Windows ou o software de rede foi configurado. Criadores de aplicativo podem usar esse número como uma indicação crua de implementação do Windows Sockets é utilizável pelo aplicativo. Por exemplo, um servidor X Windows pode marcar iMaxSockets quando iniciado pela primeira vez: se for menor que 8, o aplicativo exibirá uma mensagem de erro instruir o usuário para reconfigurar o software de rede. (Esta é uma situação em que o texto de szSystemStatus pode ser usado.) Obviamente, não há nenhuma garantia de que um determinado aplicativo realmente pode alocar iMaxSockets soquetes, desde que pode haver outros aplicativos Windows Sockets em uso.
iMaxUdpDg
O tamanho em bytes do maior datagrama do protocolo de datagrama de usuário (UDP) que pode ser enviada ou recebida por um aplicativo do Windows Sockets. Se a implementação impõe sem limite, iMaxUdpDg é zero. Em muitas implementações de soquetes Berkeley, há um limite implícito de 8192 bytes datagramas UDP (que são fragmentadas se necessário). Uma implementação de Windows Sockets pode impor um limite baseado, por exemplo, sobre a repartição dos buffers de reagrupamento de fragmento. O valor mínimo de iMaxUdpDg para uma implementação de Windows Sockets compatível é 512. Observe que, independentemente do valor de iMaxUdpDg, é desaconselhável a tentativa de enviar um datagrama de difusão que é maior do que a unidade de transmissão máxima (MTU) para a rede. (A API do Sockets Windows não fornece um mecanismo para descobrir a MTU, mas deve ter não menos de 512 bytes).
lpVendorInfo
Um ponteiro até que ponto a uma estrutura de dados específicos do fornecedor. A definição dessa estrutura (se fornecido) está além do escopo da especificação do Windows Sockets. Para obter mais informações, consulte Windows Sockets Programming considerações na documentação do Win32 SDK.
&Notanbsp; No MFC, a estrutura WSADATA é retornada pela função AfxSocketInit , que você chamar o InitInstance função. Você pode recuperar a estrutura e armazená-lo em seu programa se você precisar usar informações dele mais tarde.
Co&nsulte tambémnbsp;AfxSocketInit