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

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

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

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

要件

バージョン

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

ヘッダー

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