Функция FwpsQueryConnectionSioFormatRedirectRecords0 (fwpsk.h)

Статья
02/29/2024

Функция FwpsQueryConnectionSioFormatRedirectRecords0 возвращает записи перенаправления подключения для перенаправленного подключения. Дополнительные сведения о перенаправлении см. в разделе Использование привязки или перенаправления подключения.

ПримечаниеFwpsQueryConnectionSioFormatRedirectRecords0 — это определенная версия FwpsQueryConnectionSioFormatRedirectRecords. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .

Синтаксис

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

Параметры

[in] RedirectRecords

Записи перенаправления обрабатывают, что функция выноски ALE_CONNECT_REDIRECT, полученная в параметре inMetaValues функции classifyFn . Этот дескриптор можно найти в элементе redirectRecords структуры FWPS_INCOMING_METADATA_VALUES0 .

Запись перенаправления МПП — это буфер непрозрачных данных, который должен быть задан в исходящем прокси-подключении, чтобы перенаправленное и исходное подключение были логически связаны.

[out, optional] OutputBuffer

Указатель на выходной буфер, который получает записи перенаправления. Буфер должен быть выровнен по указателю.

[in] OutputBufferLength

Размер выходного буфера (в байтах).

[out, optional] BytesTransferred

Указатель на переменную, получающую количество переданных байтов. Если возвращаемое значение равно STATUS_BUFFER_TOO_SMALL, этот параметр получает требуемый размер буфера.

Возвращаемое значение

Возвращает значение NTSTATUS, например одно из следующих значений.

Код возврата	Описание
STATUS_BUFFER_TOO_SMALL	Выходной буфер был слишком мал, чтобы содержать все передаваемые байты. Сбой передачи данных, и требуемый размер буфера можно найти в параметре BytesTransferred .
STATUS_NOT_FOUND	Параметр RedirectRecords имеет значение NULL.

Функция FwpsQueryConnectionSioFormatRedirectRecords0 предназначена для использования драйвером выноски перенаправления подключения МПП, который не принимает перенаправленное подключение, пока не проверит возможность подключения к фактической удаленной конечной точке. Для этого драйвер выноски выполняет перенаправленный запрос на подключение на уровне FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 или FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 и вызывает FwpsQueryConnectionSioFormatRedirectRecords0 , чтобы получить записи перенаправления подключения, которые затем драйвер выноски отправляет на прокси-сервер для использования в вызове SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Универсальное
Верхняя часть	fwpsk.h (включая Fwpsk.h)
Библиотека	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL