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

Статья
02/07/2025

Функция FwpsRedirectHandleCreate0 создает дескриптор, который функции перенаправления подключений могут использовать для перенаправления подключений к локальному процессу. Дополнительные сведения о перенаправлении см. в разделе Using Bind or Connect Redirection.

ПримечаниеFwpsRedirectHandleCreate0 — это определенная версия FwpsRedirectHandleCreate. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Синтаксис

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

Параметры

providerGuid

GUID поставщика.

flags

Скрытный. Установите значение нулю.

redirectHandle

Указатель на переменную, получающую дескриптор.

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

Функция FwpsRedirectHandleCreate0 возвращает один из следующих кодов NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Дескриптор перенаправления был успешно возвращен. Переменная, на которую указывает параметр redirectHandle, содержит дескриптор.
Другие коды состояния	Произошла ошибка.

Замечания

Драйвер выноски вызывает функцию FwpsRedirectHandleCreate0 для создания дескриптора, который можно использовать для перенаправления подключений.

Дополнительные сведения о перенаправлении см. в разделе Using Bind or Connect Redirection.

Драйвер выноски должен вызывать FwpsRedirectHandleCreate0 один раз и кэшировать дескриптор, чтобы он смог повторно использовать дескриптор.

Прежде чем выноска перенаправления на уровне приложений (ALE) может перенаправлять подключения к локальному процессу, она должна получить дескриптор перенаправления с помощью функции FwpsRedirectHandleCreate0 и поместить дескриптор в структуру FWPS_CONNECT_REQUEST0. Выноска изменяет структуру в классифицироватьFn для уровней перенаправления подключения ALE.

После завершения работы драйвера выноски с помощью дескриптора перенаправления необходимо вызвать функцию FwpsRedirectHandleDesi0, чтобы уничтожить дескриптор.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Всеобщий
заголовка	fwpsk.h (include Fwpsk.h)
библиотеки	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

См. также

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDeory0

классифицироватьFn

Поделиться через