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	이름 또는 namelen 매개 변수가 사용자 주소 공간의 유효한 부분이 아니거나 namelen 매개 변수가 너무 작습니다.
WSAEINPROGRESS	콜백이 진행 중일 때 함수가 호출됩니다.
WSAENOTSOCK	설명자가 소켓이 아닙니다.
WSAENOTCONN	소켓이 연결되지 않았습니다.
WSAENOTSOCK	설명자가 소켓이 아닙니다.

설명

LPWSPGetPeerName 함수는 소켓에 연결된 피어의 이름을 제공하고 이름으로 참조되는 sockaddr 구조체에 저장합니다. 연결된 소켓에서만 사용할 수 있습니다. 데이터그램 소켓의 경우 이전 LPWSPConnect 호출에 지정된 피어의 이름만 반환되고 이전 LPWSPSendTo 호출에서 지정한 이름은 LPWSPGetPeerName에서 반환되지 않습니다.

반환할 때 namelen 매개 변수에는 바이트 단위로 반환된 이름의 실제 크기가 포함됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	ws2spi.h

추가 정보

LPWSPBind

LPWSPGetSockName

LPWSPSocket