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

Статья
08/07/2023

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

Примечание

FwpmEngineOpen0 — это конкретная версия FwpmEngineOpen. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Синтаксис

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 документации по Microsoft Windows SDK. Драйверы выносок должны указывать 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 , содержит дескриптор открытого сеанса.
Другие коды состояния	Произошла ошибка.

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows Vista.
Целевая платформа	Универсальное
Верхняя часть	fwpmk.h (включая Fwpmk.h)
Библиотека	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL