SIO_ADDRESS_LIST_QUERY
SIO_ADDRESS_LIST_QUERY通訊端 I/O 控制作業可讓 WSK 應用程式查詢通訊端位址系列目前的本機傳輸地址清單。 此通訊端 I/O 控制作業適用于所有通訊端類型。
若要查詢通訊端位址系列目前的本機傳輸地址清單,WSK 應用程式會使用下列參數呼叫 WskControlSocket 函式。
參數 | 值 |
---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_ADDRESS_LIST_QUERY |
Level |
0 |
InputSize |
0 |
InputBuffer |
NULL |
OutputSize |
OutputBuffer參數所指向緩衝區的大小,以位元組為單位。 |
OutputBuffer |
接收目前本機傳輸地址清單之緩衝區的指標。 緩衝區的大小是在 OutputSize 參數中指定。 |
OutputSizeReturned |
ULONG 型別變數的指標,可接收復制到 OutputBuffer 參數所指向之緩衝區的資料位元組數目。 |
WSK 應用程式不會在呼叫 WskControlSocket 函式時指定 IRP 的指標,以查詢通訊端位址系列目前的本機傳輸地址清單。
如果 呼叫 WskControlSocket 函式成功,輸出緩衝區會包含 SOCKET_ADDRESS_LIST 結構,後面接著通訊端位址系列之每個本機傳輸位址的 SOCKADDR 結構。
如果 WskControlSocket 函式傳回STATUS_BUFFER_OVERFLOW, OutputSizeReturned 參數所指向的變數會包含輸出緩衝區大小,以位元組為單位,這是包含通訊端位址系列之本機傳輸位址的完整清單的必要專案。
SIO_ADDRESS_LIST_CHANGE通訊端 I/O 控制作業可讓 WSK 應用程式在通訊端位址系列變更本機傳輸地址清單時收到通知。
規格需求
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Ws2def.h (包含 Wsk.h) |