SIO_ADDRESS_LIST_CHANGE

The SIO_ADDRESS_LIST_CHANGE socket I/O control operation notifies a WSK application when there has been a change to the list of local transport addresses for a socket's address family. This socket I/O control operation applies to all socket types.

To be notified when there has been a change to the list of local transport addresses for a socket's address family, a WSK application calls the WskControlSocket function with the following parameters.

Parameter Value

RequestType

WskIoctl

ControlCode

SIO_ADDRESS_LIST_CHANGE

Level

0

InputSize

0

InputBuffer

NULL

OutputSize

0

OutputBuffer

NULL

OutputSizeReturned

NULL

A WSK application must specify a pointer to an IRP when calling the WskControlSocket function to be notified of a change to the list of local transport addresses for a socket's address family. The WSK subsystem queues the IRP and returns STATUS_PENDING. If a change is made to the list of local transport addresses for the socket's address family, the WSK subsystem completes the IRP. When the IRP's completion routine is called, the WSK application can use the SIO_ADDRESS_LIST_QUERY socket I/O control operation to query the new list of local transport addresses for the socket's address family.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Ws2def.h (include Wsk.h)