Partager via


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)