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

Функция FwpmProviderContextAdd3 (fwpmu.h)

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

Синтаксис

DWORD FwpmProviderContextAdd3(
  HANDLE                       engineHandle,
  const FWPM_PROVIDER_CONTEXT3 *providerContext,
  PSECURITY_DESCRIPTOR         sd,
  UINT64                       *id
);

Параметры

engineHandle

Тип: _In_ HANDLE

Дескриптор открытого сеанса с подсистемой фильтрации. Чтобы открыть сеанс с подсистемой фильтров, вызовите FwpmEngineOpen0.

providerContext

Тип: _In_ FWPM_PROVIDER_CONTEXT3*

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

sd

Тип: _In_opt_ PSECURITY_DESCRIPTOR

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

id

Тип: _Out_opt_ UINT64*

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

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

Тип: DWORD*

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

Комментарии

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

Если указать дескриптор безопасности NULL , система назначит дескриптор безопасности по умолчанию.

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

Чтобы вызвать эту функцию, необходимо FWPM_ACTRL_ADD доступ к контейнеру контекста поставщика и FWPM_ACTRL_ADD_LINK доступ к поставщику (если таковой имеется). Дополнительные сведения см. в разделе Управление доступом.

Требования

Требование Значение
Заголовок fwpmu.h
Библиотека Fwpuclnt.lib
DLL Fwpuclnt.dll
  • Last updated on