GetAcceptExSockaddrs 함수(winsock.h)

아티클
08/27/2023

GetAcceptExSockaddrs 함수는 AcceptEx 함수 호출에서 가져온 데이터를 구문 분석하고 로컬 및 원격 주소를 sockaddr 구조체에 전달합니다.

참고 이 함수는 Windows 소켓 사양에 대한 Microsoft 전용 확장입니다.

구문

void GetAcceptExSockaddrs(
  [in]  PVOID    lpOutputBuffer,
  [in]  DWORD    dwReceiveDataLength,
  [in]  DWORD    dwLocalAddressLength,
  [in]  DWORD    dwRemoteAddressLength,
  [out] sockaddr **LocalSockaddr,
  [out] LPINT    LocalSockaddrLength,
  [out] sockaddr **RemoteSockaddr,
  [out] LPINT    RemoteSockaddrLength
);

매개 변수

[in] lpOutputBuffer

AcceptEx 호출로 인해 연결에서 전송된 첫 번째 데이터 블록을 수신하는 버퍼에 대한 포인터입니다. AcceptEx 함수에 전달된 것과 동일한 lpOutputBuffer 매개 변수여야 합니다.

[in] dwReceiveDataLength

첫 번째 데이터를 수신하는 데 사용되는 버퍼의 바이트 수입니다. 이 값은 AcceptEx 함수에 전달된 dwReceiveDataLength 매개 변수와 같아야 합니다.

[in] dwLocalAddressLength

로컬 주소 정보를 위해 예약된 바이트 수입니다. 이 값은 AcceptEx 함수에 전달된 dwLocalAddressLength 매개 변수와 같아야 합니다.

[in] dwRemoteAddressLength

원격 주소 정보를 위해 예약된 바이트 수입니다. 이 값은 AcceptEx 함수에 전달된 dwRemoteAddressLength 매개 변수와 같아야 합니다.

[out] LocalSockaddr

연결의 로컬 주소(getsockname 함수에서 반환하는 것과 동일한 정보)를 수신하는 sockaddr 구조체에 대한 포인터입니다. 이 매개 변수를 지정 합니다.

[out] LocalSockaddrLength

로컬 주소의 크기(바이트)입니다. 이 매개 변수를 지정 합니다.

[out] RemoteSockaddr

연결의 원격 주소(getpeername 함수에서 반환하는 것과 동일한 정보)를 수신하는 sockaddr 구조체에 대한 포인터입니다. 이 매개 변수를 지정 합니다.

[out] RemoteSockaddrLength

로컬 주소의 크기(바이트)입니다. 이 매개 변수를 지정 합니다.

반환 값

없음

설명

GetAcceptExSockaddrs 함수는 AcceptEx 함수와 함께 단독으로 사용되어 소켓이 수신하는 첫 번째 데이터를 로컬 및 원격 주소로 구문 분석합니다. AcceptEx 함수는 내부 형식으로 로컬 및 원격 주소 정보를 반환합니다. 로컬 또는 원격 주소를 포함하는 sockaddr 구조체가 필요한 경우 애플리케이션 개발자는 GetAcceptExSockaddrs 함수를 사용해야 합니다.

참고GetAcceptExSockaddrs 함수에 대한 함수 포인터는 지정된 SIO_GET_EXTENSION_FUNCTION_POINTER opcode를 사용하여 WSAIoctl 함수를 호출하여 런타임에 가져와야 합니다. WSAIoctl 함수에 전달된 입력 버퍼에는 값이 GetAcceptExSockaddrs 확장 함수를 식별하는 GUID(Globally Unique Identifier)인 WSAID_GETACCEPTEXSOCKADDRS 포함되어야 합니다. 성공하면 WSAIoctl 함수에서 반환된 출력에 GetAcceptExSockaddrs 함수에 대한 포인터가 포함됩니다. WSAID_GETACCEPTEXSOCKADDRS GUID는 Mswsock.h 헤더 파일에 정의되어 있습니다.

Windows Phone 8: 이 함수는 Windows Phone 8 이상에서 Windows Phone 스토어 앱에서 지원됩니다.

Windows 8.1 및 Windows Server 2012 R2: 이 함수는 Windows 8.1, Windows Server 2012 R2 이상에서 Windows 스토어 앱에서 지원됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1, Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	winsock.h(Mswsock.h 포함)
라이브러리	Mswsock.lib
DLL	Mswsock.dll