Función FwpsQueryConnectionSioFormatRedirectRecords0 (fwpsk.h)

Artículo
08/07/2023

La función FwpsQueryConnectionSioFormatRedirectRecords0 devuelve los registros de redirección de conexión para una conexión redirigida. Para obtener más información sobre el redireccionamiento, consulte Uso del redireccionamiento de enlace o conexión.

NotaFwpsQueryConnectionSioFormatRedirectRecords0 es una versión específica de FwpsQueryConnectionSioFormatRedirectRecords. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

Sintaxis

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

Parámetros

[in] RedirectRecords

Los registros de redireccionamiento controlan que la función de llamada ALE_CONNECT_REDIRECT recibida en el parámetro inMetaValues de su función classifyFn . Este identificador se puede encontrar en el miembro redirectRecords de la estructura FWPS_INCOMING_METADATA_VALUES0 .

Un registro de redireccionamiento de PMA es un búfer de datos opacos que EL PMA debe establecer en una conexión de proxy de salida para que la conexión redirigida y la conexión original estén relacionadas lógicamente.

[out, optional] OutputBuffer

Puntero a un búfer de salida que recibe los registros de redirección. El búfer debe estar alineado con el puntero.

[in] OutputBufferLength

Tamaño, en bytes, del búfer de salida.

[out, optional] BytesTransferred

Puntero a una variable que recibe el número de bytes transferidos. Si el valor devuelto es STATUS_BUFFER_TOO_SMALL, este parámetro recibe el tamaño de búfer necesario.

Valor devuelto

Devuelve un valor NTSTATUS como uno de los siguientes.

Código devuelto	Descripción
STATUS_BUFFER_TOO_SMALL	El búfer de salida era demasiado pequeño para contener todos los bytes que se van a transferir. Error en la transferencia de datos y el tamaño de búfer necesario se puede encontrar en el parámetro BytesTransferred .
STATUS_NOT_FOUND	El parámetro RedirectRecords era null.

Comentarios

La función FwpsQueryConnectionSioFormatRedirectRecords0 solo se aplica a servidores proxy locales.

Para obtener más información sobre el redireccionamiento, consulte Uso del redireccionamiento de enlace o conexión.

La función FwpsQueryConnectionSioFormatRedirectRecords0 está diseñada para ser utilizada por un controlador de llamada de redirección de conexión PMA que no acepta la conexión redirigida hasta que haya comprobado que puede conectarse al punto de conexión remoto real. Para ello, el controlador de llamada inserta la solicitud de conexión redirigida en la capa de FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 o FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 y llama a FwpsQueryConnectionSioFormatRedirectRecords0 para recuperar los registros de redirección de conexión, que el controlador de llamada envía al proxy para que se use en una llamada a SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Universal
Encabezado	fwpsk.h (incluya Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL