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 포함) |