Funzione di callback LPWSPGETPEERNAME (ws2spi.h)
La funzione LPWSPGetPeerName ottiene l'indirizzo del peer a cui è connesso un socket.
Sintassi
LPWSPGETPEERNAME Lpwspgetpeername;
int Lpwspgetpeername(
[in] SOCKET s,
[out] sockaddr *name,
[in, out] LPINT namelen,
[out] LPINT lpErrno
)
{...}
Parametri
[in] s
Descrittore che identifica un socket connesso.
[out] name
Puntatore alla struttura sockaddr per ricevere il nome del peer.
[in, out] namelen
In input, puntatore a un intero che indica le dimensioni della struttura a cui punta per nome, in byte. Nell'output indica la dimensione del nome restituito, in byte.
[out] lpErrno
Puntatore al codice di errore.
Valore restituito
Se non si verifica alcun errore, LPWSPGetPeerName restituisce zero. In caso contrario, viene restituito un valore di SOCKET_ERROR e un codice di errore specifico è disponibile in lpErrno.
| Codice di errore | Significato |
|---|---|
| Il sottosistema di rete non è riuscito. | |
| Il nome o il parametro namelen non è una parte valida dello spazio indirizzi utente oppure il parametro namelen è troppo piccolo. | |
| La funzione viene richiamata quando un callback è in corso. | |
| Il descrittore non è un socket. | |
| Socket non connesso. | |
| Il descrittore non è un socket. |
Commenti
La funzione LPWSPGetPeerName fornisce il nome del peer connesso al socket s e lo archivia nella struttura sockaddr a cui fa riferimento per nome. Può essere usato solo in un socket connesso. Per i socket datagram, verrà restituito solo il nome di un peer specificato in una chiamata LPWSPConnect precedente e qualsiasi nome specificato da una chiamata LPWSPSendTo precedente non verrà restituita da LPWSPGetPeerName.
In caso di restituzione, il parametro namelen contiene le dimensioni effettive del nome restituito in byte.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | ws2spi.h |