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