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 は 0 を返します。 それ以外の場合は、SOCKET_ERRORの値が返され、 lpErrno で特定のエラー コードを使用できます。

エラー コード 意味
WSAENETDOWN
 ネットワーク サブシステムが失敗しました。
WSAEFAULT
 name パラメーターまたは namelen パラメーターがユーザー アドレス空間の有効な部分ではないか、namelen パラメーターが小さすぎます。
WSAEINPROGRESS
 関数は、コールバックが進行中のときに呼び出されます。
WSAENOTSOCK
 記述子はソケットではありません。
WSAENOTCONN
 ソケットが接続されていません。
WSAENOTSOCK
 記述子はソケットではありません。

注釈

LPWSPGetPeerName 関数は、ソケット s に接続されているピアの名前を提供し、名前で参照される構造体 sockaddr に格納します。 接続されているソケットでのみ使用できます。 データグラム ソケットの場合、前の LPWSPConnect 呼び出しで指定されたピアの名前のみが返され、以前の LPWSPSendTo 呼び出しで指定された名前は LPWSPGetPeerName によって返されません。

返された namelen パラメーターには、返される名前の実際のサイズがバイト単位で格納されます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header ws2spi.h

こちらもご覧ください

LPWSPBind

LPWSPGetSockName

LPWSPSocket