SIO_WSK_SET_REMOTE_ADDRESS

L'operazione di controllo I/O socket SIO_WSK_SET_REMOTE_ADDRESS consente a un'applicazione WSK di specificare un indirizzo di trasporto remoto fisso per un socket datagram. Questa operazione di controllo I/O socket si applica solo ai socket datagram.

Se un'applicazione WSK imposta un indirizzo di trasporto remoto fisso per un socket datagram, tutti i datagrammi inviati tramite il socket vengono inviati all'indirizzo di trasporto remoto fisso e vengono accettati solo i datagrammi ricevuti dall'indirizzo di trasporto remoto fisso.

Un'applicazione WSK può eseguire l'override di un indirizzo di trasporto remoto fisso quando invia un datagram sul socket specificando un indirizzo di trasporto remoto alternativo nel parametro RemoteAddress quando si chiama la funzione WskSendTo . In questa situazione, il datagram viene inviato all'indirizzo di trasporto remoto alternativo anziché all'indirizzo di trasporto remoto fisso. Tuttavia, tutte le risposte inviate da un indirizzo di trasporto remoto alternativo non verranno accettate.

Se un'applicazione WSK usa questa operazione di controllo I/O socket per specificare un indirizzo di trasporto remoto fisso, deve farlo dopo che il socket di datagram è stato associato a un indirizzo di trasporto locale.

Per impostare un indirizzo di trasporto remoto fisso per un socket di datagram, un'applicazione WSK chiama la funzione WskControlSocket con i parametri seguenti.

Parametro	Valore
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
Level	0
InputSize	Dimensioni della struttura SOCKADDR a cui punta il parametro InputBuffer .
Inputbuffer	Puntatore a una struttura che specifica un indirizzo di trasporto remoto fisso per il socket del datagram. Il puntatore deve essere un puntatore al tipo di struttura SOCKADDR specifico che corrisponde alla famiglia di indirizzi specificata dall'applicazione WSK quando ha creato il socket del datagram.
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL

Per cancellare un indirizzo di trasporto remoto fisso per un socket di datagram, un'applicazione WSK chiama la funzione WskControlSocket con i parametri seguenti.

Parametro	Valore
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
Level	0
InputSize	0
Inputbuffer	NULL
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL

Un'applicazione WSK deve specificare un puntatore a un'IRP quando si chiama la funzione WskControlSocket per impostare o cancellare un indirizzo di trasporto remoto fisso per un socket di datagram.

Requisiti

Versione	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	Wsk.h (include Wsk.h)