LPWSPGETPEERNAME 回呼函式 (ws2spi.h)

  • 發行項

LPWSPGetPeerName 函式會取得套接字所連接的對等位址。

語法

LPWSPGETPEERNAME Lpwspgetpeername;

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

參數

[in] s

識別已連線套接字的描述項。

[out] name

要接收對等名稱 之sockaddr 結構的指標。

[in, out] namelen

在輸入上，以位元組為單位的整數指標，指出 依名稱所指向的結構大小。 在輸出中，以位元組為單位表示傳回的名稱大小。

[out] lpErrno

錯誤碼的指標。

傳回值

如果沒有發生錯誤， LPWSPGetPeerName 會傳回零。 否則，會傳回SOCKET_ERROR值，而且 lpErrno 中提供特定的錯誤碼。

錯誤碼 意義
WSAENETDOWN
 網路子系統失敗。
WSAEFAULT
 name 或 namelen 參數不是使用者位址空間的有效部分，或 namelen 參數太小。
WSAEINPROGRESS
 當回呼正在進行時，就會叫用函式。
WSAENOTSOCK
 描述項不是套接字。
WSAENOTCONN
 通訊端未連線。
WSAENOTSOCK
 描述項不是套接字。

備註

LPWSPGetPeerName 函式提供連接到套接字 s 的對等名稱，並將它儲存在名稱所參考的結構 sockaddr 中。 它只能在連接的套接字上使用。 對於數據報套接字，只會傳回先前 LPWSPConnect 呼叫中指定的對等名稱，而且先前 的 LPWSPSendTo 呼叫所指定的任何名稱都不會由 LPWSPGetPeerName 傳回。

傳回時， namelen 參數包含以位元組為單位傳回之名稱的實際大小。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 ws2spi.h

另請參閱

LPWSPBind

LPWSPGetSockName

LPWSPSocket