code de contrôle SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS

L’opération de contrôle E/S du socket SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS permet à un client Winsock de spécifier l’enregistrement de redirection vers le nouveau socket TCP utilisé pour la connexion à la destination finale.

Un enregistrement de redirection PAM est une mémoire tampon de données opaques que le PAM doit définir sur une connexion proxy sortante afin que la connexion redirigée et la connexion d’origine soient logiquement liées.

Pour plus d’informations sur la redirection, consultez Utilisation de la redirection de liaison ou de connexion.

Pour définir l’enregistrement de redirection sur le nouveau socket TCP utilisé pour la connexion à la destination finale, un client Winsock appelle la fonction WskControlSocket avec les paramètres suivants.

Paramètre	Valeur
RequestType	WskIoctl
ControlCode	SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS
Niveau	0
InputSize	Taille de l’enregistrement de redirection pointé vers le paramètre InputBuffer.
InputBuffer	Pointeur vers l’enregistrement de redirection associé au socket.
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL
Irp	Pointeur vers un IRP.

Le client Winsock doit allouer une mémoire tampon et spécifier un pointeur vers la mémoire tampon et sa taille dans InputBuffer et InputSize.

Un client Winsock doit spécifier un pointeur vers un IRP et une routine d’achèvement lors de l’appel de la fonction WskControlSocket pour ce type de requête. Le client ne doit pas libérer la mémoire tampon tant que le sous-système WSK n’a pas terminé l’IRP. Une fois l’IRP terminée, le sous-système appelle la routine d’achèvement. Dans la routine d’achèvement, le client doit case activée le status IRP et libérer toutes les ressources qu’il avait précédemment allouées pour la demande.

Note Il est également possible d’effectuer cette requête dans une application en mode utilisateur à l’aide de SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK).

Pour plus d’informations sur la gestion des IRP WSK, consultez Utilisation des IRP avec des fonctions de noyau Winsock.

Le client peut obtenir le status de l’IRP en vérifiant Irp-IoStatus.Status>. Irp-> IoStatus.Status sera défini sur STATUS_SUCCESS si la demande réussit. Sinon, il contiendra STATUS_INTEGER_OVERFLOW ou STATUS_ACCESS_DENIED si l’appel échoue.

Configuration requise

Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
En-tête	Mstcpip.h
IRQL	PASSIVE_LEVEL

Voir aussi

Utilisation de la redirection de liaison ou de connexion

Utilisation des IIP avec les fonctions du noyau Winsock

SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK)