Udostępnij przez


SIO_WSK_SET_REMOTE_ADDRESS

Operacja sterowania we/wy gniazda SIO_WSK_SET_REMOTE_ADDRESS umożliwia aplikacji WSK określenie stałego adresu transportu zdalnego dla gniazda datagramu. Ta operacja sterowania we/wy gniazda ma zastosowanie tylko do gniazd datagramu.

Jeśli aplikacja WSK ustawia stały adres transportu zdalnego dla gniazda datagramu, wszystkie datagramy wysyłane przez gniazdo są wysyłane do stałego adresu transportu zdalnego, a akceptowane są tylko datagramy odbierane z stałego adresu transportu zdalnego.

Aplikacja WSK może zastąpić stały adres transportu zdalnego podczas wysyłania datagramu przez gniazdo, określając alternatywny adres transportu zdalnego w parametrze RemoteAddress podczas wywoływania funkcji WskSendTo. W takiej sytuacji datagram jest wysyłany do alternatywnego adresu transportu zdalnego zamiast stałego adresu transportu zdalnego. Jednak wszelkie odpowiedzi wysyłane z powrotem z alternatywnego adresu transportu zdalnego nie zostaną zaakceptowane.

Jeśli aplikacja WSK używa tej operacji sterowania we/wy gniazda w celu określenia stałego adresu transportu zdalnego, musi to zrobić po tym, jak gniazdo datagramu zostało powiązane z lokalnym adresem transportu.

Aby ustawić stały adres transportu zdalnego dla gniazda datagramu, aplikacja WSK wywołuje funkcję WskControlSocket z następującymi parametrami.

Parametr Wartość

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_REMOTE_ADDRESS

poziom

0

InputSize

Rozmiar struktury SOCKADDR wskazywany przez parametr InputBuffer.

InputBuffer

Wskaźnik do struktury, która określa stały adres transportu zdalnego gniazda datagramu. Wskaźnik musi być wskaźnikiem do określonego typu struktury SOCKADDR, który odpowiada rodzinie adresów określonej przez aplikację WSK podczas tworzenia gniazda datagramu.

OutputSize

0

OutputBuffer

ZERO

OutputSizeReturned

ZERO

Aby wyczyścić stały adres transportu zdalnego dla gniazda datagramu, aplikacja WSK wywołuje funkcję WskControlSocket z następującymi parametrami.

Parametr Wartość

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_REMOTE_ADDRESS

poziom

0

InputSize

0

InputBuffer

ZERO

OutputSize

0

OutputBuffer

ZERO

OutputSizeReturned

ZERO

Aplikacja WSK musi określić wskaźnik do protokołu IRP podczas wywoływania funkcji WskControlSocket w celu ustawienia lub wyczyszczenia stałego adresu transportu dla gniazda datagramu.

Wymagania

Wersja

Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.

Nagłówek

Wsk.h (w tym Wsk.h)