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

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

  • Статья

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

Синтаксис

NTSTATUS FwpmSubLayerAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_SUBLAYER0 *subLayer,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

Параметры

[in] engineHandle

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

[in] subLayer

Подложка, добавляемая.

[in, optional] sd

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

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

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

Замечания

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

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

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

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

Требования

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

См. также