Função WSACreateEvent (winsock2.h)
A função WSACreateEvent cria um novo objeto de evento.
Sintaxe
WSAEVENT WSAAPI WSACreateEvent();
Valor retornado
Se nenhum erro ocorrer, WSACreateEvent retornará o identificador do objeto de evento. Caso contrário, o valor retornado será WSA_INVALID_EVENT. Para obter informações de erro estendidas, chame WSAGetLastError.
| Código do erro | Significado |
|---|---|
| Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função. | |
| O subsistema de rede falhou. | |
| Uma chamada do Windows Sockets 1.1 de bloqueio está em andamento ou o provedor de serviços ainda está processando uma função de retorno de chamada. | |
| Não há memória livre suficiente disponível para criar o objeto de evento. |
Comentários
A função WSACreateEvent cria um objeto de evento de redefinição manual com um estado inicial de não atribuído. O identificador do objeto de evento retornado não pode ser herdado por processos filho. O objeto de evento não tem nome.
A função WSASetEvent pode ser chamada para definir o estado do objeto de evento como sinalizado. A função WSAResetEvent pode ser chamada para definir o estado do objeto de evento como não atribuído. Quando um objeto de evento não é mais necessário, a função WSACloseEvent deve ser chamada para liberar os recursos associados ao objeto de evento.
Objetos de evento do Windows Sockets 2 são objetos do sistema em ambientes windows. Portanto, se um aplicativo do Windows quiser usar um evento de redefinição automática em vez de um evento de redefinição manual, o aplicativo poderá chamar a função CreateEvent diretamente. O escopo de um objeto de evento é limitado ao processo no qual ele é criado.
Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.
Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posterior.
Requisitos
| Cliente mínimo com suporte | Windows 8.1, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | winsock2.h |
| Biblioteca | Ws2_32.lib |
| DLL | Ws2_32.dll |