FwpsRedirectHandleCreate0, fonction (fwpsk.h)
La fonction FwpsRedirectHandleCreate0 crée un handle que les fonctions de redirection de connexion peuvent utiliser pour rediriger les connexions vers un processus local. Pour plus d’informations sur la redirection, consultez Utilisation de la redirection de liaison ou de connexion.
Syntaxe
NTSTATUS FwpsRedirectHandleCreate0(
const GUID *providerGuid,
UINT32 flags,
HANDLE *redirectHandle
);
Paramètres
providerGuid
GUID du fournisseur.
flags
Réservé. Définit la valeur zéro.
redirectHandle
Pointeur vers la variable qui reçoit le handle.
Valeur retournée
La fonction FwpsRedirectHandleCreate0 retourne l’un des codes NTSTATUS suivants.
| Code de retour | Description |
|---|---|
|
Un handle de redirection a été retourné avec succès. La variable vers laquelle pointe le paramètre redirectHandle contient le handle. |
|
Une erreur est survenue. |
Remarques
Un pilote de légende appelle la fonction FwpsRedirectHandleCreate0 pour créer un handle qui peut être utilisé pour rediriger les connexions.
Pour plus d’informations sur la redirection, consultez Utilisation de la redirection de liaison ou de connexion.
Votre pilote de légende doit appeler FwpsRedirectHandleCreate0 une fois et mettre en cache le handle afin qu’il puisse réutiliser le handle.
Avant qu’une légende de redirection de connexion Application Layer Enforcement (ALE) puisse rediriger les connexions vers un processus local, elle doit obtenir un handle de redirection avec la fonction FwpsRedirectHandleCreate0 et placer le handle dans la structure FWPS_CONNECT_REQUEST0 . La légende modifie la structure dans le classifyFn pour les couches de redirection ale connect.
Une fois qu’un pilote de légende a fini d’utiliser un handle de redirection, il doit appeler la fonction FwpsRedirectHandleDestroy0 pour détruire le handle.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 |
| Serveur minimal pris en charge | Windows Server 2012 |
| Plateforme cible | Universal |
| En-tête | fwpsk.h (include Fwpsk.h) |
| Bibliothèque | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |