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

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

  • Статья

Функция FwpmProviderAdd0 добавляет нового поставщика в систему.

Синтаксис

NTSTATUS FwpmProviderAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_PROVIDER0 *provider,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

Параметры

[in] engineHandle

Обработка открытого сеанса в обработчике фильтров. Вызовите FwpmEngineOpen0, чтобы открыть сеанс в обработчике фильтров.

[in] provider

Добавляемый объект поставщика.

[in, optional] sd

Сведения о безопасности объекта поставщика.

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

Возврат кода или значения Описание
ERROR_SUCCESS
0		 Поставщик успешно добавлен.
FWP_E_* код ошибки
0x80320001 — 0x80320039		 Конкретная ошибка платформы фильтрации Windows (МПП). Дополнительные сведения см. в кодов ошибок МПП.
код ошибки RPC_*
0x80010001 — 0x80010122		 Не удаляйте связь с подсистемой удаленного или локального брандмауэра.
другие коды NTSTATUS Произошла ошибка.

Замечания

Если вызывающий объект предоставляет дескриптор безопасности NULL, система назначит дескриптор безопасности по умолчанию.

Объекты времени загрузки добавляются в подсистему базовой фильтрации (BFE) при запуске драйвера TCP/IP и удаляются после завершения инициализации BFE. Постоянные объекты добавляются при запуске BFE. Если поставщик политик имеет постоянную политику, которая не предназначена для принудительного применения, если связанная служба отключена, вызывающий объект может указать необязательное имя службы в структуре FWPM_PROVIDER0. Затем эта служба владеет объектом постоянной политики. Сначала BFE добавляет в систему только следующие типы постоянных объектов.

  • Объект не связан с поставщиком.
  • У объекта есть связанный поставщик, который не указывает имя службы.
  • Объект имеет связанного поставщика и связанную службу, установленную для автоматического запуска.

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

Вызывающий объект должен FWPM_ACTRL_ADD доступ к контейнеру поставщика. Дополнительные сведения см. в управления доступом.

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

Требования

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

См. также