Funzione FwpsRedirectHandleCreate0 (fwpsk.h)

Articolo
02/29/2024

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

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

Sintassi

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

Parametri

providerGuid

GUID del provider.

flags

Riservato. Imposta 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 correttamente un handle di reindirizzamento. Variabile che il parametro redirectHandle punta a contiene l'handle.
Altri codici di stato	Si è verificato un errore.

Commenti

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

Per altre informazioni sul reindirizzamento, vedere Uso di Bind o Connect Redirection.

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

Prima di un callout di reindirizzamento connessione application layer enforcement (ALE) può 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 livello di classificazioneFn per i livelli di reindirizzamento di connessione ALE.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (includere Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Vedi anche

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classificazioneFn

Condividi tramite