Share via

LPWSPGETPEERNAME-Rückruffunktion (ws2spi.h)

  • Artikel

Die LPWSPGetPeerName-Funktion ruft die Adresse des Peers ab, mit dem ein Socket verbunden ist.

Syntax

LPWSPGETPEERNAME Lpwspgetpeername;

int Lpwspgetpeername(
  [in]      SOCKET s,
  [out]     sockaddr *name,
  [in, out] LPINT namelen,
  [out]     LPINT lpErrno
)
{...}

Parameter

[in] s

Deskriptor, der einen verbundenen Socket identifiziert.

[out] name

Zeiger auf die sockaddr-Struktur , um den Namen des Peers zu erhalten.

[in, out] namelen

Zeigen Sie bei der Eingabe auf eine ganze Zahl, die die Größe der Struktur angibt, auf die anhand des Namens in Bytes verwiesen wird. Gibt bei der Ausgabe die Größe des zurückgegebenen Namens in Bytes an.

[out] lpErrno

Zeiger auf den Fehlercode.

Rückgabewert

Wenn kein Fehler auftritt, gibt LPWSPGetPeerName null zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode ist in lpErrno verfügbar.

Fehlercode Bedeutung
WSAENETDOWN
 Fehler beim Netzwerksubsystem.
WSAEFAULT
 Der Name oder der namelen-Parameter ist kein gültiger Teil des Benutzeradressraums, oder der namelen-Parameter ist zu klein.
WSAEINPROGRESS
 Die Funktion wird aufgerufen, wenn ein Rückruf ausgeführt wird.
WSAENOTSOCK
 Der Deskriptor ist kein Socket.
WSAENOTCONN
 „Socket ist nicht verbunden.“
WSAENOTSOCK
 Der Deskriptor ist kein Socket.

Hinweise

Die LPWSPGetPeerName-Funktion stellt den Namen des Peers bereit, der mit den Sockets verbunden ist, und speichert ihn in der Struktur sockaddr , auf die anhand des Namens verwiesen wird. Sie kann nur für einen verbundenen Socket verwendet werden. Für Datagrammsockets wird nur der Name eines Peers zurückgegeben, der in einem vorherigen LPWSPConnect-Aufruf angegeben wurde, und jeder durch einen vorherigen LPWSPSendTo-Aufruf angegebene Name wird von LPWSPGetPeerName nicht zurückgegeben.

Bei der Rückgabe enthält der namelen-Parameter die tatsächliche Größe des zurückgegebenen Namens in Bytes.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile ws2spi.h

Weitere Informationen

LPWSPBind

LPWSPGetSockName

LPWSPSocket