SIO_WSK_SET_REMOTE_ADDRESS

SIO_WSK_SET_REMOTE_ADDRESS套接字 I/O 控制操作允许 WSK 应用程序为数据报套接字指定固定远程传输地址。 此套接字 I/O 控制操作仅适用于数据报套接字。

如果 WSK 应用程序为数据报套接字设置固定远程传输地址,则通过该套接字发送的所有数据报将发送到固定远程传输地址,并且仅接受从固定远程传输地址接收的数据报。

当 WSK 应用程序通过套接字发送数据报时,WSK 应用程序可以通过在调用 WskSendTo 函数时在 RemoteAddress 参数中指定备用远程传输地址来替代固定远程传输地址。 在这种情况下,数据报将发送到备用远程传输地址,而不是固定的远程传输地址。 但是,将不接受从备用远程传输地址发回的任何响应。

如果 WSK 应用程序使用此套接字 I/O 控制操作来指定固定的远程传输地址,则必须在数据报套接字绑定到本地传输地址之后执行此操作。

若要为数据报套接字设置固定的远程传输地址,WSK 应用程序使用以下参数调用 WskControlSocket 函数。

参数

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_REMOTE_ADDRESS

级别

0

InputSize

InputBuffer 参数指向的 SOCKADDR 结构的大小。

InputBuffer

指向 结构的指针,该结构指定数据报套接字的固定远程传输地址。 指针必须是指向特定 SOCKADDR 结构类型的指针,该类型对应于 WSK 应用程序在创建数据报套接字时指定的地址系列。

OutputSize

0

OutputBuffer

Null

OutputSizeReturned

Null

为了清除数据报套接字的固定远程传输地址,WSK 应用程序使用以下参数调用 WskControlSocket 函数。

参数

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_REMOTE_ADDRESS

级别

0

InputSize

0

InputBuffer

Null

OutputSize

0

OutputBuffer

Null

OutputSizeReturned

Null

调用 WskControlSocket 函数时,WSK 应用程序必须指定指向 IRP 的指针,以设置或清除数据报套接字的固定远程传输地址。

要求

版本

在 Windows Vista 和更高版本的 Windows 操作系统中可用。

标头

Wsk.h (包括 Wsk.h)