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

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

  • Статья

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

Синтаксис

NTSTATUS FwpmProviderContextDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

Параметры

[in] engineHandle

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

[in] key

Уникальный идентификатор объекта, который удаляется из системы. Это указатель на тот же GUID, который был указан при вызове приложения FwpmProviderContextAdd0 для этого объекта.

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

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

Замечания

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

Эта функция может вызываться в динамическом сеансе, если соответствующий объект был добавлен во время того же сеанса. Если эта функция вызывается для объекта, добавленного во время другого динамического сеанса, он завершится ошибкой с FWP_E_WRONG_SESSION. Если эта функция вызывается для объекта, который не был добавлен во время динамического сеанса, он завершится ошибкой с FWP_E_DYNAMIC_SESSION_IN_PROGRESS.

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

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

Требования

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

См. также