Función FwpsRedirectHandleCreate0 (fwpsk.h)
La función FwpsRedirectHandleCreate0 crea un identificador que las funciones de redirección de conexión pueden usar para redirigir las conexiones a un proceso local. Para obtener más información sobre el redireccionamiento, consulte Uso del redireccionamiento de enlace o conexión.
Sintaxis
NTSTATUS FwpsRedirectHandleCreate0(
const GUID *providerGuid,
UINT32 flags,
HANDLE *redirectHandle
);
Parámetros
providerGuid
Guid del proveedor.
flags
Reservado. Establecer en cero.
redirectHandle
Puntero a la variable que recibe el identificador.
Valor devuelto
La función FwpsRedirectHandleCreate0 devuelve uno de los siguientes códigos NTSTATUS.
| Código devuelto | Descripción |
|---|---|
|
Se devolvió correctamente un identificador de redireccionamiento. La variable a la que apunta el parámetro redirectHandle contiene el identificador . |
|
Se produjo un error. |
Comentarios
Un controlador de llamada llama a la función FwpsRedirectHandleCreate0 para crear un identificador que se pueda usar para redirigir las conexiones.
Para obtener más información sobre el redireccionamiento, consulte Uso del redireccionamiento de enlace o conexión.
El controlador de llamada debe llamar a FwpsRedirectHandleCreate0 una vez y almacenar en caché el identificador para que pueda reutilizar el identificador.
Antes de que una llamada de redirección de conexión de Application Layer Enforcement (ALE) pueda redirigir las conexiones a un proceso local, debe obtener un identificador de redireccionamiento con la función FwpsRedirectHandleCreate0 y colocar el identificador en la estructura de FWPS_CONNECT_REQUEST0 . La llamada modifica la estructura de la clasificaciónFn para las capas de redirección de conexión de ALE.
Una vez que un controlador de llamada haya terminado de usar un identificador de redireccionamiento, debe llamar a la función FwpsRedirectHandleDestroy0 para destruir el identificador.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Universal |
| Encabezado | fwpsk.h (incluya Fwpsk.h) |
| Library | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |