Funzione WSAResetEvent (winsock2.h)

La funzione WSAResetEvent reimposta lo stato dell'oggetto evento specificato su nonsignaled.

Sintassi

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

Parametri

[in] hEvent

Handle che identifica un handle dell'oggetto evento aperto.

Valore restituito

Se la funzione WSAResetEvent ha esito positivo, il valore restituito è TRUE. Se la funzione ha esito negativo, il valore restituito è FALSE. Per ottenere informazioni sull'errore estese, chiamare WSAGetLastError.

Codice di errore Significato
WSANOTINITIALISED
Prima di usare questa funzione, è necessario eseguire una chiamata WSAStartup riuscita.
WSAENETDOWN
Il sottosistema di rete non è riuscito.
WSAEINPROGRESS
Una chiamata windows Sockets 1.1 bloccata è in corso oppure il provider di servizi sta ancora elaborando una funzione di callback.
WSA_INVALID_HANDLE
Il parametro hEvent non è un handle dell'oggetto evento valido.

Commenti

La funzione WSAResetEvent viene usata per impostare lo stato dell'oggetto evento su nonsignaled.

Il modo appropriato per reimpostare lo stato di un oggetto evento usato con la funzione WSAEventSelect consiste nel passare l'handle dell'oggetto evento alla funzione WSAEnumNetworkEvents nel parametro hEventObject . Verrà reimpostato l'oggetto evento e si regola lo stato degli eventi FD attivi sul socket in modo atomico.

Windows Phone 8: questa funzione è supportata per le app Windows Phone Store in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

   
Client minimo supportato Windows 8.1, Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione winsock2.h
Libreria Ws2_32.lib
DLL Ws2_32.dll

Vedi anche

WSACloseEvent

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSASetEvent

Funzioni Winsock

Informazioni di riferimento su Winsock