Share via


SOCKET_ADDRESS_LIST 구조체(ws2def.h)

SOCKET_ADDRESS_LIST 구조체는 가변 크기의 전송 주소 목록을 정의합니다.

구문

typedef struct _SOCKET_ADDRESS_LIST {
  INT            iAddressCount;
  SOCKET_ADDRESS Address[1];
} SOCKET_ADDRESS_LIST, *PSOCKET_ADDRESS_LIST, *LPSOCKET_ADDRESS_LIST;

멤버

iAddressCount

목록의 전송 주소 수입니다.

Address[1]

SOCKET_ADDRESS 구조체의 가변 크기 배열입니다. SOCKET_ADDRESS 구조체는 다음과 같이 정의됩니다.

typedef struct _SOCKET_ADDRESS {
  LPSOCKADDR  lpSockaddr;
  INT  iSockaddrLength;
} SOCKET_ADDRESS, *PSOCKET_ADDRESS, *LPSOCKET_ADDRESS;

lpSockaddr

전송 주소를 포함하는 버퍼에 대한 포인터입니다.

iSockaddrLength

lpSockaddr 멤버가 가리키는 SOCKADDR 구조체 형식의 크기(바이트)입니다.

설명

WSK 애플리케이션이 소켓의 주소 패밀리와 일치하는 로컬 전송 주소의 현재 목록을 쿼리할 때 WSK 애플리케이션은 WskControlSocket 함수에 버퍼를 전달합니다. WskControlSocket 함수에 대한 호출이 성공하면 버퍼에는 SOCKET_ADDRESS_LIST 구조와 소켓의 주소 패밀리와 일치하는 각 로컬 전송 주소에 대한 SOCKADDR 구조가 포함됩니다. WSK 하위 시스템은 주소 배열을 채우고 iAddressCount 멤버를 배열의 항목 수로 설정합니다. 배열의 각 SOCKET_ADDRESS 구조체에 있는 lpSockaddr 포인터는 WSK 애플리케이션이 소켓을 만들 때 지정한 주소 패밀리에 해당하는 특정 SOCKADDR 구조 형식을 가리킵니다.

현재 로컬 전송 주소 목록을 쿼리하는 방법에 대한 자세한 내용은 SIO_ADDRESS_LIST_QUERY 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글 ws2def.h(Wsk.h 포함)

추가 정보

SIO_ADDRESS_LIST_QUERY

SOCKADDR

WskControlSocket