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

Функция FwpmEngineOpen0 (fwpmk.h)

  • Статья

Функция FwpmEngineOpen0 открывает сеанс для модуля фильтрации.

Синтаксис

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

Параметры

[in, optional] serverName

Указатель на строку, завершающую значение NULL, которая указывает стандартное DNS-имя системы, на которую открывается сеанс с подсистемой фильтрации. Драйверы выноски должны указывать NULL для этого параметра.

[in] authnService

Используемая служба проверки подлинности. Список допустимых вариантов этого параметра см. в разделе Authentication-Service "Константы RPC" в документации по пакету SDK для Microsoft Windows. Драйверы выноски должны указывать либо RPC_C_AUTHN_WINNT, либо RPC_C_AUTHN_DEFAULT для этого параметра.

[in, optional] authIdentity

Указатель на структуру SEC_WINNT_AUTH_IDENTITY_W, содержащую учетные данные проверки подлинности и авторизации для доступа к обработчику фильтров. Этот параметр игнорируется при вызове функции FwpmEngineOpen0 из драйвера выноски. Драйверы выноски должны задать этот параметр для null.

[in, optional] session

Указатель на структуру FWPM_SESSION0, которая определяет параметры для открываемого сеанса. Этот указатель необязателен и может быть null.

[out] engineHandle

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

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

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

Возвращаемый код Описание
STATUS_SUCCESS Сеанс в обработчике фильтров был успешно открыт. Переменная, на которую указывает параметр engineHandle, содержит дескриптор открытого сеанса.
другие коды NTSTATUS Произошла ошибка.

Замечания

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

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

Чтобы драйвер выноски успешно открыл сеанс в обработчике фильтров, подсистема фильтров должна работать в данный момент, когда драйвер выноски вызывает функцию FwpmEngineOpen0. Драйвер выноски может вызвать функцию FwpmBfeStateGet0, чтобы получить текущее состояние обработчика фильтров. Перед вызовом FwpmBfeStateGet0драйвер выноски должен вызвать функцию FwpmBfeBfeStateSubscribeChanges0, чтобы зарегистрировать функцию обратного вызова, которая будет вызываться при изменении состояния обработчика фильтров.

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows Vista.
целевая платформа Всеобщий
заголовка fwpmk.h (include Fwpmk.h)
библиотеки Fwpkclnt.lib
IRQL PASSIVE_LEVEL

См. также