Using WSAStartup to Initialize Winsock
.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
Um aplicativo deve chamar o WSAStartup função para inicializar sockets do Windows (Winsock), regardless of qual versão do sockets do Windows (Winsock) está sendo usado. WSAStartup Inicializa Winsock2.dll e um WSADATA estrutura que contém os detalhes da implementação de sockets do Windows (Winsock). Quando um aplicativo ou DLL tiver terminado usando Winsock2.dll, ele deve chamar WSACleanup Para habilitar Ws2.dll para livre quaisquer recursos para o aplicativo. Para cada chamar para WSAStartup, deve haver um chamar para WSACleanup.
O seguinte exemplo de código mostra como usar WSAStartup.
if (WSAStartup (MAKEWORD(2,2), &WSAData) != 0)
{
MessageBox (NULL, TEXT("WSAStartup failed!"), TEXT("Error"), MB_OK);
return FALSE;
}
Se bem-sucedido, WSAStartup Retorna 0. Após WSAStartup Retorna, um aplicativo não é possível chamar WSAGetLastError Para determinar o valor de erro
O WSADATA estrutura apontada pelo lpWSAData Armazena dados retornados por uma chamar a inicialização sockets do Windows (Winsock) WSAStartup. WSADATA Contém dados implementação Ws2.dll. Um aplicativo ou DLL pode chamar WSAStartup repetidamente se ela precisar obter o WSADATA dados estrutura mais de uma vez.
A seguinte tabela mostra os valores que WSAStartup Atribui aos membros do WSADATA.
| Membro WSADATA | Valor atribuído |
|---|---|
wVersion |
2.2 |
wHighVersion |
2.2 |
szDescription |
NULL seqüência de caracteres |
szSystemStatus |
NULL seqüência de caracteres |
iMaxSockets |
100 |
iMaxUdpDg |
0 |
lpVendorInfo |
NULL |
See Also
Reference
WSAStartup
WSADATA
WSACleanup
WSAGetLastError