SIO_ADDRESS_LIST_QUERY
La operación de control de E/S de socket SIO_ADDRESS_LIST_QUERY permite a una aplicación WSK consultar la lista actual de direcciones de transporte local para la familia de direcciones de un socket. Esta operación de control de E/S de socket se aplica a todos los tipos de socket.
Para consultar la lista actual de direcciones de transporte local para la familia de direcciones de un socket, una aplicación WSK llama a la función WskControlSocket con los parámetros siguientes.
Parámetro | Value |
---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_ADDRESS_LIST_QUERY |
Level |
0 |
InputSize |
0 |
InputBuffer |
NULL |
OutputSize |
Tamaño, en bytes, del búfer al que apunta el parámetro OutputBuffer . |
OutputBuffer |
Puntero al búfer que recibe la lista actual de direcciones de transporte locales. El tamaño del búfer se especifica en el parámetro OutputSize . |
OutputSizeReturned |
Puntero a una variable con tipo ULONG que recibe el número de bytes de datos que se copian en el búfer al que apunta el parámetro OutputBuffer . |
Una aplicación WSK no especifica un puntero a un IRP al llamar a la función WskControlSocket para consultar la lista actual de direcciones de transporte local para la familia de direcciones de un socket.
Si la llamada a la función WskControlSocket se realiza correctamente, el búfer de salida contiene una estructura de SOCKET_ADDRESS_LIST seguida de las estructuras SOCKADDR para cada una de las direcciones de transporte locales de la familia de direcciones del socket.
Si la función WskControlSocket devuelve STATUS_BUFFER_OVERFLOW, la variable a la que apunta el parámetro OutputSizeReturned contiene el tamaño del búfer de salida, en bytes, necesario para contener la lista completa de direcciones de transporte local para la familia de direcciones del socket.
La operación de control de E/S de socket SIO_ADDRESS_LIST_CHANGE permite recibir una notificación a una aplicación WSK cuando se ha producido un cambio en la lista de direcciones de transporte local de la familia de direcciones de un socket.
Requisitos
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Ws2def.h (incluye Wsk.h) |