Funzione FwpsQueryConnectionSioFormatRedirectRecords0 (fwpsk.h)

Articolo
08/07/2023

La funzione FwpsQueryConnectionSioFormatRedirectRecords0 restituisce i record di reindirizzamento della connessione per una connessione reindirizzata. Per altre informazioni sul reindirizzamento, vedere Using Bind or Connect Redirection.For more information about redirection, see Using Bind or Connect Redirection.

NotaFwpsQueryConnectionSioFormatRedirectRecords0 è una versione specifica di FwpsQueryConnectionSioFormatRecords. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Sintassi

NTSTATUS FwpsQueryConnectionSioFormatRedirectRecords0(
  [in]            HANDLE  RedirectRecords,
  [out, optional] PVOID   OutputBuffer,
  [in]            SIZE_T  OutputBufferLength,
  [out, optional] PSIZE_T BytesTransferred
);

Parametri

[in] RedirectRecords

I record di reindirizzamento gestiscono che la ALE_CONNECT_REDIRECT funzione callout ricevuta nel parametro inMetaValues della relativa funzione classifyFn . Questo handle è disponibile nel membro redirectRecords della struttura FWPS_INCOMING_METADATA_VALUES0 .

Un record di reindirizzamento WFP è un buffer di dati opachi che il WFP deve impostare su una connessione proxy in uscita in modo che la connessione reindirizzata e la connessione originale siano logicamente correlate.

[out, optional] OutputBuffer

Puntatore a un buffer di output che riceve i record di reindirizzamento. Il buffer deve essere allineato al puntatore.

[in] OutputBufferLength

Dimensione, in byte, del buffer di output.

[out, optional] BytesTransferred

Puntatore a una variabile che riceve il numero di byte trasferiti. Se il valore restituito è STATUS_BUFFER_TOO_SMALL, questo parametro riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce un valore NTSTATUS, ad esempio uno dei seguenti.

Codice restituito	Descrizione
STATUS_BUFFER_TOO_SMALL	Il buffer di output era troppo piccolo per contenere tutti i byte da trasferire. Il trasferimento dei dati non è riuscito e le dimensioni del buffer necessarie sono disponibili nel parametro BytesTransferred .
STATUS_NOT_FOUND	Il parametro RedirectRecords è null.

Commenti

La funzione FwpsQueryConnectionSioFormatRedirectRecords0 si applica solo ai proxy locali.

Per altre informazioni sul reindirizzamento, vedere Using Bind or Connect Redirection.For more information about redirection, see Using Bind or Connect Redirection.

La funzione FwpsQueryConnectionSioFormatRedirectRecords0 è progettata per essere usata da un driver callout di reindirizzamento connessione WFP che non accetta la connessione reindirizzata fino a quando non ha verificato che sia in grado di connettersi all'endpoint remoto effettivo. A tale scopo, il driver del callout esegue la richiesta di connessione reindirizzata al livello FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 o FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 e chiama FwpsQueryConnectionSioFormatRecords0 per recuperare i record di reindirizzamento della connessione, che il driver callout invia quindi al proxy da usare in una chiamata a SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (include Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL