WSADATA
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa estrutura é usada para armazenar dados retornados por uma chamar a inicialização Soquetes do Windows WSAStartup.
Syntax
typedef struct WSAData {
WORD wVersion;
WORD wHighVersion;
char szDescription[WSADESCRIPTION_LEN+1];
char szSystemStatus[WSASYS_STATUS_LEN+1];
unsigned short iMaxSockets;
unsigned short iMaxUdpDg;
char FAR* lpVendorInfo;
} WSADATA, *LPWSADATA;
Os membros
- wVersion
Versão de Specificationthat de Soquetes do Windows o ws2_32.dll espera que o chamador usar.
- wHighVersion
Versão mais alto de Windows Sockets Specification que este DLL pode suporte (também codificado como acima). Normalmente, esse é o mesmo que wVersion.
- szDescription
No qual o ws2_32.dll copia uma descrição da implementação de Soquetes do Windows seqüência de caracteres ASCII NULL-Terminated. O texto (até 256 caracteres de comprimento) pode conter quaisquer caracteres, exceto controle e formatação caracteres. Use o provável que um aplicativo pode pôr isso para exibi-lo (possivelmente truncado) em uma mensagem status.
- szSystemStatus
Null-Terminated seqüência de caracteres ASCII no qual o WSs2_32.dll copia informações relevantes status ou configuração. O ws2_32.dll deve usar este parâmetro somente se as informações podem ser úteis à equipe de suporte ou usuário. Ele não deve ser considerado como uma extensão das szDescription parâmetro.
- iMaxSockets
Mantido para compatibilidade com versões anteriores, mas deve ser ignorada para sockets do Windows (Winsock) 2.0 e posterior, como nenhum valor único pode ser apropriado para subjacente todos os provedores serviço.
- iMaxUdpDg
Ignorado para sockets do Windows (Winsock) 2.0 e posterior. Esse membro é mantido para compatibilidade com Winsock 1.1, mas não deve ser usado ao desenvolver novos aplicativos. Para o real específica tamanho máximo de mensagem para um determinado Soquetes do Windows serviço provedor e Soquete tipo, os aplicativos devem usar getsockopt (Soquetes do Windows) Para recuperar o valor de opção SO_MAX_MSG_SIZE Após ter sido criado um Soquete.
- lpVendorInfo
Ignorado para sockets do Windows (Winsock) 2.0 e posterior. Ele é mantido para compatibilidade com Winsock 1.1. Aplicativos precisar acessar informações configuração Vendor-Specific devem usar getsockopt (Soquetes do Windows) Para recuperar o valor de opção PVD_CONFIG. A definição desse valor está fora de escopo dessa especificação.
Remarks
Se, após um bem-sucedido chamar para WSAStartup, o valor em wVersion é pelo menos 2, um aplicativo deve ignorar o iMaxsockets, iMaxUdpDg, e lpVendorInfo Os membros. Isso ocorre porque 2.2 sockets do Windows (Winsock) suporta múltiplo provedores, e WSAData não estiver mais sendo aplicado para uma pilha único fornecedor. Duas novas opções Soquete, SO_MAX_MSG_SIZE e PVD_CONFIG fornecer informações Provider-specific. SO_MAX_MSG_SIZE Substitui iMaxUdpDg, e PVD_CONFIG Permite configuração de outras informações Provider-specific.
Requirements
| Header | winsock2.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |