Estrutura WSADATA

The WSADATA estrutura é usada para armazenar informações de inicialização do Windows Sockets retornadas por uma telefonar para o AfxSocketInit função global.

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

Parâmetros

• wVersion
  A versão da especificação do Windows Sockets que a DLL do Windows Sockets espera o chamador para use.

• wHighVersion
  A versão mais alta da especificação do Windows Sockets que oferece suporte a essa DLL (também codificada sistema autônomo acima).Normalmente, esse é o mesmo sistema autônomo wVersion.

• szDescription
  Uma cadeia de ASCII terminada com nulo em que a DLL do Windows Sockets copia uma descrição da implementação do Windows Sockets, incluindo a identificação de fornecedor.O texto (até 256 caracteres de comprimento) pode conter quaisquer caracteres, mas os fornecedores são cautioned contra incluindo controle e a formatação de caracteres: o uso mais provável que coloca um aplicativo está para exibi-la (possivelmente truncado) em uma mensagem de status.

• szSystemStatus
  Uma cadeia de ASCII terminada com nulo em que a DLL do Windows Sockets copia informações de status ou a configuração relevantes.A DLL do Windows Sockets devem usar este campo somente se sistema autônomo informações podem ser úteis para o usuário ou equipe de suporte; não deve ser considerado sistema autônomo uma extensão do szDescription campo.

• iMaxSockets
  O número máximo de soquetes que potencialmente pode em em aberto um único processo.Uma implementação do Windows Sockets pode fornecer um pool de soquetes global para alocação para qualquer processo; como alternativa, ele pode alocar recursos por processo para soquetes.O número também pode refletir a maneira em que a DLL do Windows Sockets ou o software de rede foi configurado.Autores de aplicativos podem usar esse número sistema autônomo uma indicação crua se a implementação do Windows Sockets é utilizável pelo aplicativo.Por exemplo, um servidor X Windows pode verificar iMaxSockets quando iniciou pela primeira vez: Se for menor que 8, o aplicativo poderia exibir uma mensagem de erro instruindo o usuário para reconfigurar o software de rede.(Esta é uma situação na qual o szSystemStatus texto pode ser usado.) Obviamente, não há nenhuma garantia de que um determinado aplicativo pode alocar realmente iMaxSockets soquetes, como há podem outros aplicativos do Windows Sockets em uso.

• iMaxUdpDg
  O dimensionar em bytes, do maior datagrama UDP (protocolo UDP) que podem ser enviadas ou recebidas por um aplicativo do Windows Sockets.Se a implementação não impõe limites, iMaxUdpDg é zero.Em muitas implementações de soquetes de Berkeley, há um limite implícito de 8192 bytes datagramas UDP (que são fragmentadas se necessário).Uma implementação do Windows Sockets pode impor um limite com base, por exemplo, na alocação de buffers de remontagem de fragmento.O valor mínimo de iMaxUdpDg para uma implementação compatível com Windows Sockets é 512.Observe que, independentemente do valor de iMaxUdpDg, é tenta enviar um datagrama de difundido é maior do que a unidade máxima de transmissão (MTU) para a rede.(A API do Windows Sockets não fornece um mecanismo para descobrir a MTU, mas ele deve ser não menor que 512 bytes).

• lpVendorInfo
  Um ponteiro oposto para 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.

Observação:
No MFC, o WSADATA estrutura retornada pela AfxSocketInit função, o qual você telefonar no seu InitInstance função. Você pode recuperar a estrutura e armazená-lo em seu programa caso você precise usar as informações dele mais tarde.

Requisitos

Cabeçalho: winsock2.h

Consulte também

Referência

AfxSocketInit

Outros recursos

Estruturas, estilos, retornos de chamada e mapas de mensagem