Compartilhar via


Função SocketNotificationRetrieveEvents (winsock2.h)

Essa função auxiliar embutida é fornecida como uma conveniência para recuperar a máscara de eventos de um OVERLAPPED_ENTRY.

Para obter mais informações e exemplos de código, consulte Notificações de estado do soquete Winsock.

Sintaxe

UINT32 SocketNotificationRetrieveEvents(
  OVERLAPPED_ENTRY *notification
);

Parâmetros

notification

Tipo: _In_ OVERLAPPED_ENTRY*

Um ponteiro para um OVERLAPPED_ENTRY recebido para uma notificação de estado de soquete.

Retornar valor

Um UINT32 que contém uma máscara de bits dos eventos de notificação para o soquete.

Esta tabela lista os eventos de notificação de soquete. Esses são os eventos possíveis quando uma notificação é recebida.

Evento Descrição
SOCK_NOTIFY_EVENT_IN A entrada está disponível no soquete sem bloqueio.
SOCK_NOTIFY_EVENT_OUT A saída pode ser fornecida ao soquete sem bloqueio.
SOCK_NOTIFY_EVENT_HANGUP A conexão de soquete foi encerrada.
SOCK_NOTIFY_EVENT_ERR O soquete está em um estado de erro.
SOCK_NOTIFY_EVENT_REMOVE A notificação foi desregistrado.

Comentários

Os eventos SOCK_NOTIFY_EVENT_ERR e SOCK_NOTIFY_EVENT_REMOVE podem ser indicados independentemente do filtro de evento registrado.

Se um evento SOCK_NOTIFY_EVENT_REMOVE for indicado, não serão fornecidas mais notificações.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Cabeçalho winsock2.h
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também