SIO_WSK_SET_SENDTO_ADDRESS

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

Jeśli aplikacja WSK ustawia stały docelowy adres transportu gniazda datagramu, wszystkie datagramy wysyłane przez gniazdo są wysyłane do stałego adresu transportu docelowego. Jednak datagramy odbierane na gniazdach zostaną zaakceptowane z dowolnego adresu transportu.

Aplikacja WSK może zastąpić stały adres transportu docelowego 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 docelowego.

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

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

Parametr	Wartość
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_SENDTO_ADDRESS
poziom	0
InputSize	Rozmiar struktury SOCKADDR wskazywany przez parametr InputBuffer.
InputBuffer	Wskaźnik do struktury, która określa stały adres transportu docelowego 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 docelowy adres transportu gniazda datagramu, aplikacja WSK wywołuje funkcję WskControlSocket z następującymi parametrami.

Parametr	Wartość
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_SENDTO_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 docelowego 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)