SIO_WSK_SET_REMOTE_ADDRESS
SIO_WSK_SET_REMOTE_ADDRESS通訊端 I/O 控制作業可讓 WSK 應用程式指定資料包通訊端的固定遠端傳輸位址。 此通訊端 I/O 控制作業僅適用于資料包通訊端。
如果 WSK 應用程式設定資料包通訊端的固定遠端傳輸位址,則會將透過通訊端傳送的所有資料包傳送至固定遠端傳輸位址,而且只接受從固定遠端傳輸位址接收的資料包。
WSK 應用程式可以在呼叫WskSendTo函式時,藉由在RemoteAddress參數中指定替代遠端傳輸位址,在通訊端上傳送資料包時覆寫固定遠端傳輸位址。 在此情況下,資料包會傳送至替代遠端傳輸位址,而不是固定遠端傳輸位址。 不過,將不會接受從替代遠端傳輸位址傳回的任何回應。
如果 WSK 應用程式使用此通訊端 I/O 控制作業來指定固定遠端傳輸位址,則必須在資料包通訊端系結至本機傳輸位址之後執行此動作。
若要設定資料包通訊端的固定遠端傳輸位址,WSK 應用程式會使用下列參數呼叫 WskControlSocket 函式。
參數 | 值 |
---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_WSK_SET_REMOTE_ADDRESS |
Level |
0 |
InputSize |
InputBuffer參數所指向的 SOCKADDR 結構大小。 |
InputBuffer |
結構的指標,指定資料包通訊端的固定遠端傳輸位址。 指標必須是特定 SOCKADDR 結構類型的指標,對應至建立資料包通訊端時所指定的 WSK 應用程式所指定的位址系列。 |
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
若要清除資料包通訊端的固定遠端傳輸位址,WSK 應用程式會使用下列參數呼叫 WskControlSocket 函式。
參數 | 值 |
---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_WSK_SET_REMOTE_ADDRESS |
Level |
0 |
InputSize |
0 |
InputBuffer |
NULL |
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
呼叫 WskControlSocket 函式時,WSK 應用程式必須指定 IRP 的指標,才能設定或清除資料包通訊端的固定遠端傳輸位址。
規格需求
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Wsk.h (包括 Wsk.h) |