SIO_WSK_SET_SENDTO_ADDRESS

SIO_WSK_SET_SENDTO_ADDRESS ソケット I/O 制御操作を使用すると、WSK アプリケーションは、データグラム ソケットの固定宛先トランスポート アドレスを指定できます。 このソケット I/O 制御操作は、データグラム ソケットにのみ適用されます。

WSK アプリケーションがデータグラム ソケットの固定宛先トランスポート アドレスを設定すると、ソケット経由で送信されるすべてのデータグラムが固定宛先トランスポート アドレスに送信されます。 ただし、ソケットで受信されたデータグラムは、任意のトランスポート アドレスから受け入れられます。

WSK アプリケーションは、WskSendTo 関数を呼び出すときに RemoteAddress パラメーターで代替リモート トランスポート アドレスを指定することで、ソケット経由でデータグラムを送信するときに固定宛先トランスポート アドレスをオーバーライドできます。 この状況では、データグラムは固定宛先トランスポート アドレスではなく代替リモート トランスポート アドレスに送信されます。

WSK アプリケーションでこのソケット I/O 制御操作を使用して固定宛先トランスポート アドレスを指定する場合は、データグラム ソケットがローカル トランスポート アドレスにバインドされた後に指定する必要があります。

データグラム ソケットの固定宛先トランスポート アドレスを設定するには、WSK アプリケーションは、次のパラメーターを使用して WskControlSocket 関数を呼び出します。

パラメーター

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_SENDTO_ADDRESS

Level

0

InputSize

InputBuffer パラメーターが指す SOCKADDR 構造体のサイズ。

InputBuffer

データグラム ソケットの固定宛先トランスポート アドレスを指定する構造体へのポインター。 ポインターは、WSK アプリケーションがデータグラム ソケットの作成時に指定したアドレス ファミリに対応する特定の SOCKADDR 構造体型へのポインターである必要があります。

OutputSize

0

OutputBuffer

NULL

OutputSizeReturned

NULL

データグラム ソケットの固定宛先トランスポート アドレスをクリアするには、WSK アプリケーションは、次のパラメーターを使用して WskControlSocket 関数を呼び出します。

パラメーター

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_SENDTO_ADDRESS

Level

0

InputSize

0

InputBuffer

NULL

OutputSize

0

OutputBuffer

NULL

OutputSizeReturned

NULL

WSK アプリケーションは、WskControlSocket 関数を呼び出すときに IRP へのポインターを指定して、データグラム ソケットの固定宛先トランスポート アドレスを設定またはクリアする必要があります。

要件

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダー

Wsk.h (Wsk.h のインクルード)