Funzione WSAResetEvent (winsock2.h)

Articolo
08/27/2023

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