Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’opération de contrôle d’E/S de 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 liées logiquement.
Pour plus d’informations sur la redirection, consultez Using Bind or Connect Redirection.
Pour définir l’enregistrement de redirection vers 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 vers lequel pointe le paramètre InputBuffer. |
InputBuffer |
Pointeur vers l’enregistrement de redirection associé au socket. |
OutputSize |
0 |
OutputBuffer |
ZÉRO |
OutputSizeReturned |
ZÉRO |
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 du WskControlSocket fonction 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é, le sous-système appelle la routine d’achèvement. Dans la routine d’achèvement, le client doit vérifier l’état IRP et libérer toutes les ressources qu’il avait précédemment allouées pour la demande.
Remarque 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 d’IRPs avec Winsock Kernel Functions.
Le client peut obtenir l’état 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 n’a pas réussi.
Exigences
Client minimum pris en charge |
Windows 8 |
Serveur minimum pris en charge |
Windows Server 2012 |
En-tête |
Mstcpip.h |
IRQL |
PASSIVE_LEVEL |
Voir aussi
à l’aide d’une de redirection de liaison ou de connexion
utilisation d’IRPs avec des fonctions de noyau Winsock