SIO_ADDRESS_LIST_QUERY

SIO_ADDRESS_LIST_QUERY 소켓 I/O 제어 작업을 사용하면 WSK 애플리케이션이 소켓의 주소 패밀리에 대한 로컬 전송 주소의 현재 목록을 쿼리할 수 있습니다. 이 소켓 I/O 컨트롤 작업은 모든 소켓 유형에 적용됩니다.

소켓의 주소 패밀리에 대한 로컬 전송 주소의 현재 목록을 쿼리하기 위해 WSK 애플리케이션은 다음 매개 변수를 사용하여 WskControlSocket 함수를 호출합니다.

매개 변수

RequestType

WskIoctl

ControlCode

SIO_ADDRESS_LIST_QUERY

수준

0

InputSize

0

InputBuffer

NULL

OutputSize

OutputBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

OutputBuffer

로컬 전송 주소의 현재 목록을 수신하는 버퍼에 대한 포인터입니다. 버퍼의 크기는 OutputSize 매개 변수에 지정됩니다.

OutputSizeReturned

OutputBuffer 매개 변수가 가리키는 버퍼에 복사되는 데이터 바이트 수를 수신하는 ULONG 형식 변수에 대한 포인터입니다.

WSK 애플리케이션은 WskControlSocket 함수를 호출하여 소켓의 주소 패밀리에 대한 로컬 전송 주소의 현재 목록을 쿼리할 때 IRP에 대한 포인터를 지정하지 않습니다.

WskControlSocket 함수에 대한 호출이 성공하면 출력 버퍼에는 SOCKET_ADDRESS_LIST 구조와 소켓의 주소 패밀리에 대한 각 로컬 전송 주소에 대한 SOCKADDR 구조가 포함됩니다.

WskControlSocket 함수가 STATUS_BUFFER_OVERFLOW 반환하는 경우 OutputSizeReturned 매개 변수가 가리키는 변수에는 소켓의 주소 패밀리에 대한 로컬 전송 주소의 전체 목록을 포함하는 데 필요한 출력 버퍼 크기(바이트)가 포함됩니다.

SIO_ADDRESS_LIST_CHANGE 소켓 I/O 제어 작업을 사용하면 소켓의 주소 패밀리에 대한 로컬 전송 주소 목록이 변경된 경우 WSK 애플리케이션에 알림을 받을 수 있습니다.

요구 사항

Version

Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.

헤더

Ws2def.h(Wsk.h 포함)