Функция FwpsAcquireClassifyHandle0 (fwpsk.h)

Статья
02/07/2025

Функция FwpsAcquireClassifyHandle 0 создает дескриптор классификации, который используется для идентификации асинхронных операций классификации и запросов для записываемых данных слоя.

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

Синтаксис

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

Параметры

[in] classifyContext

Параметр classifyContext из classifyFn1. Подсистема МПП передает это значение в драйвера выноски классифицировать.

[in] flags

Зарезервировано для дальнейшего использования. Установите значение 0.

[out] classifyHandle

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

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

Функция FwpsAcquireClassifyHandle0 возвращает один из следующих кодов NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Дескриптор для запроса классификации был успешно возвращен. Переменная, на которую указывает параметр classifyHandle, содержит дескриптор для запроса классификации.
Другие коды состояния	Произошла ошибка.

Замечания

FwpsAcquireClassifyHandle0 — это функция поддержки асинхронной классификации и изменения данных. Дескриптор, возвращаемый этой функцией, требуется в качестве параметра для следующих функций:

Для каждого вызова этой функции драйвер выноски должен вызывать FwpsReleaseClassifyHandle0, чтобы освободить системные ресурсы, связанные с дескриптором.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 7.
целевая платформа	Всеобщий
заголовка	fwpsk.h (include Fwpsk.h)
библиотеки	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

См. также

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

классифицироватьFn

классифицироватьFn1

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