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

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

  • Статья

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

Синтаксис

NTSTATUS FwpmProviderContextAdd1(
  [in]            HANDLE                       engineHandle,
  [in]            const FWPM_PROVIDER_CONTEXT1 *providerContext,
  [in, optional]  PSECURITY_DESCRIPTOR         sd,
  [out, optional] UINT64                       *id
);

Параметры

[in] engineHandle

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

[in] providerContext

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

[in, optional] sd

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

[out, optional] id

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

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

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

Замечания

Некоторые поля в структуре FWPM_PROVIDER_CONTEXT1 назначаются системой, а не вызывающим, и игнорируются в вызове FwpmProviderContextAdd1.

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

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

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

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

Требования

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

См. также