SIO_WSK_SET_REMOTE_ADDRESS

L’opération de contrôle d’E/S du socket SIO_WSK_SET_REMOTE_ADDRESS permet à une application WSK de spécifier une adresse de transport distante fixe pour un socket de datagramme. Cette opération de contrôle d’E/S de socket s’applique uniquement aux sockets de datagramme.

Si une application WSK définit une adresse de transport à distance fixe pour un socket de datagramme, tous les datagrammes envoyés via le socket sont envoyés à l’adresse de transport distante fixe et seuls les datagrammes reçus à partir de l’adresse de transport distante fixe sont acceptés.

Une application WSK peut remplacer une adresse de transport distante fixe lorsqu’elle envoie un datagramme sur le socket en spécifiant une autre adresse de transport distante dans le paramètre RemoteAddress lors de l’appel de la fonction WskSendTo . Dans ce cas, le datagramme est envoyé à l’adresse de transport distante alternative au lieu de l’adresse de transport à distance fixe. Toutefois, les réponses renvoyées à partir d’une autre adresse de transport à distance ne seront pas acceptées.

Si une application WSK utilise cette opération de contrôle d’E/S de socket pour spécifier une adresse de transport distante fixe, elle doit le faire une fois que le socket du datagramme a été lié à une adresse de transport locale.

Pour définir une adresse de transport à distance fixe pour un socket de datagramme, une application WSK appelle la fonction WskControlSocket avec les paramètres suivants.

Paramètre	Valeur
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
Niveau	0
InputSize	Taille de la structure SOCKADDR pointée vers le paramètre InputBuffer .
InputBuffer	Pointeur vers une structure qui spécifie une adresse de transport distante fixe pour le socket de datagramme. Le pointeur doit être un pointeur vers le type de structure SOCKADDR spécifique qui correspond à la famille d’adresses spécifiée par l’application WSK lors de la création du socket de datagramme.
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL

Pour effacer une adresse de transport distante fixe pour un socket de datagramme, une application WSK appelle la fonction WskControlSocket avec les paramètres suivants.

Paramètre	Valeur
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
Niveau	0
InputSize	0
InputBuffer	NULL
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL

Une application WSK doit spécifier un pointeur vers un IRP lors de l’appel de la fonction WskControlSocket pour définir ou effacer une adresse de transport distante fixe pour un socket de datagramme.

Spécifications

Version	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	Wsk.h (inclure Wsk.h)