Compartilhar via


Estrutura WSADATA

O WSADATA estrutura é usada para armazenar informações de inicialização do Windows Sockets retornadas por uma chamada 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 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
    Uma seqüência de ASCII terminada por caractere nulo 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 atenção máxima dos contra incluindo controle e 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
    Uma seqüência de ASCII terminada por caractere nulo 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 oferecer suporte à equipe; não deve ser considerado como uma extensão de szDescription campo.

  • iMaxSockets
    O número máximo de soquetes que um único processo potencialmente pode abrir.Uma implementação de Windows Sockets pode fornecer um pool global de soquetes para alocação de qualquer processo; Como alternativa, 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.Autores de aplicativos podem usar esse número como 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 iniciado pela primeira vez: se for menor que 8, o aplicativo poderia exibir uma mensagem instruindo o usuário reconfigurar o software de rede.(Esta é uma situação em que o szSystemStatus texto pode ser usado.) Obviamente, não há nenhuma garantia que um determinado aplicativo pode alocar realmente iMaxSockets soquetes, pois pode haver outros aplicativos Windows Sockets em uso.

  • iMaxUdpDg
    O tamanho em bytes do maior datagrama de protocolo de datagrama de usuário (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 de 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 compatível com Windows Sockets implementação é 512.Observe que, independentemente do valor de iMaxUdpDg, não é aconselhável tentar enviar um datagrama de difusão é maior do que a Maximum Transmission Unit (MTU) para a rede.(A API do Windows Sockets não oferece um mecanismo para descobrir a MTU, mas ele deve ser não menor que 512 bytes).

  • lpVendorInfo
    Ponteiro mais distante de 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çãoObservação

No MFC, o WSADATA estrutura é retornada pelo AfxSocketInit função chamada no seu InitInstance função.Você pode recuperar a estrutura e armazená-lo no seu programa se você precisar usar informações dele posteriormente.

Requisitos

Cabeçalho: Winsock2. h

Consulte também

Referência

AfxSocketInit

Outros recursos

Estruturas, estilos, retornos de chamada e mapas de mensagem