Função WSACreateEvent (winsock2.h)

Artigo
08/27/2023

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
WSANOTINITIALISED	Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função.
WSAENETDOWN	O subsistema de rede falhou.
WSAEINPROGRESS	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.
WSA_NOT_ENOUGH_MEMORY	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