共用方式為


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)