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

  • Статья

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

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

 

Синтаксис

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

Параметры

providerGuid

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

flags

Зарезервировано. Задайте нулевое значение.

redirectHandle

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

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

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

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

Комментарии

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

Дополнительные сведения о перенаправлении см. в разделе Использование привязки или перенаправления подключения.

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

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

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

Требования

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

См. также раздел

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDeкистраль0

classifyFn