Funzione FwpsRedirectHandleCreate0 (fwpsk.h)

  • Articolo

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