Функция 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 |