SIO_WSK_SET_SENDTO_ADDRESS

L’opération de contrôle d’E/S du socket SIO_WSK_SET_SENDTO_ADDRESS permet à une application WSK de spécifier une adresse de transport de destination 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 de destination fixe pour un socket de datagramme, tous les datagrammes envoyés via le socket sont envoyés à l’adresse de transport de destination fixe. Toutefois, les datagrammes reçus sur le socket seront acceptés à partir de n’importe quelle adresse de transport.

Une application WSK peut remplacer une adresse de transport de destination 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 de destination fixe.

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

Pour définir une adresse de transport de destination 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_SENDTO_ADDRESS
Niveau	0
InputSize	Taille de la structure SOCKADDR vers laquelle pointe le paramètre InputBuffer .
InputBuffer	Pointeur vers une structure qui spécifie une adresse de transport de destination 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 de destination 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_SENDTO_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 de destination 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)