Funzione FwpsRedirectHandleCreate0 (fwpsk.h)

Articolo
02/07/2025

La funzione FwpsRedirectHandleCreate0 crea un handle che le funzioni di reindirizzamento delle connessioni possono usare per reindirizzare le connessioni a un processo locale. Per altre informazioni sul reindirizzamento, vedere Using Bind or Connect Redirection.

NotaFwpsRedirectHandleCreate0 è una versione specifica di FwpsRedirectHandleCreate. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

NTSTATUS FwpsRedirectHandleCreate0(
  const GUID *providerGuid,
  UINT32     flags,
  HANDLE     *redirectHandle
);

Parametri

providerGuid

GUID del provider.

flags

Riservato. Impostare su zero.

redirectHandle

Puntatore alla variabile che riceve l'handle.

Valore restituito

La funzione FwpsRedirectHandleCreate0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	È stato restituito un handle di reindirizzamento. Variabile che il redirectHandle parametro punta a contiene l'handle.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Un driver callout chiama la funzione FwpsRedirectHandleCreate0 per creare un handle che può essere usato per reindirizzare le connessioni.

Per altre informazioni sul reindirizzamento, vedere Using Bind or Connect Redirection.

Il driver callout deve chiamare FwpsRedirectHandleCreate0 una sola volta e memorizzare nella cache l'handle in modo che possa riutilizzare l'handle.

Prima che un callout di reindirizzamento della connessione del livello applicazione (ALE) possa reindirizzare le connessioni a un processo locale, deve ottenere un handle di reindirizzamento con la funzione FwpsRedirectHandleCreate0 e inserire l'handle nella struttura FWPS_CONNECT_REQUEST0. Il callout modifica la struttura nel classificareFn per i livelli di reindirizzamento di connessione ALE.

Al termine dell'uso di un handle di reindirizzamento, un driver callout deve chiamare la funzione fwpsRedirectHandleDestroy0 per eliminare definitivamente l'handle.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Universale
intestazione	fwpsk.h (include Fwpsk.h)
libreria	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Vedere anche

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classificareFn

Condividi tramite