Funzione WSAGetLastError (winsock.h)

Articolo
08/27/2023

La funzione WSAGetLastError restituisce lo stato di errore per l'ultima operazione di Windows Sockets non riuscita.

Sintassi

int WSAGetLastError();

Valore restituito

Il valore restituito indica il codice di errore per l'ultima operazione di Windows Sockets del thread non riuscita.

Commenti

La funzione WSAGetLastError restituisce l'ultimo errore che si è verificato per il thread chiamante. Quando si è verificata una particolare funzione Windows Sockets, questa funzione deve essere chiamata immediatamente per recuperare il codice di errore esteso per la chiamata di funzione non riuscita. Questo codice di errore esteso può essere diverso dal codice di errore ottenuto da getsockopt quando viene chiamato con un parametro optname di SO_ERROR, che è specifico del socket perché WSAGetLastError è per tutti i socket specifici del thread.

Se il valore restituito di una chiamata di funzione indica che l'errore o altri dati pertinenti sono stati restituiti nel codice di errore, WSAGetLastError deve essere chiamato immediatamente. Ciò è necessario perché alcune funzioni possono reimpostare l'ultimo codice di errore esteso su 0 se hanno esito positivo, sovrascrivendo il codice di errore esteso restituito da una funzione precedentemente non riuscita. Per reimpostare in modo specifico il codice di errore esteso, usare la chiamata di funzione WSASetLastError con il parametro iError impostato su zero. Una funzione getsockopt quando viene chiamata con un parametro optname di SO_ERROR reimposta anche il codice di errore esteso su zero.

La funzione WSAGetLastError non deve essere utilizzata per verificare la presenza di un valore di errore esteso alla ricezione di un messaggio asincrono. In questo caso, il valore di errore esteso viene passato nel parametro lParam del messaggio e ciò può essere diverso dal valore restituito da WSAGetLastError.

Nota Un'applicazione può chiamare la funzione WSAGetLastError per determinare il codice di errore esteso per altre funzioni socket di Windows come avviene normalmente in Windows Sockets anche se la funzione WSAStartup ha esito negativo o la funzione WSAStartup non è stata chiamata per inizializzare correttamente Windows Sockets prima di chiamare una funzione Windows Sockets. La funzione WSAGetLastError è una delle uniche funzioni della DLL Winsock 2.2 che può essere chiamata in caso di errore WSAStartup .

I codici di errore estesi di Windows Sockets restituiti da questa funzione e la descrizione del testo dell'errore sono elencati in Codici di errore di Windows Sockets. Questi codici di errore e una breve descrizione di testo associati a un codice di errore sono definiti nel file di intestazione Winerror.h . La funzione FormatMessage può essere usata per ottenere la stringa di messaggio per l'errore restituito.

Per informazioni su come gestire i codici di errore durante la conversione di applicazioni socket in Winsock, vedere Codici di errore - errno, h_errno e WSAGetLastError.

Windows Phone 8: questa funzione è supportata per le app dello Store di Windows Phone 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	winsock.h (include Winsock2.h)
Libreria	Ws2_32.lib
DLL	Ws2_32.dll