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

  • Статья

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

ПримечаниеFwpsAcquireClassifyHandle0 — это определенная версия FwpsAcquireClassifyHandle. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .
 

Синтаксис

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

Параметры

[in] classifyContext

Параметр classifyContext из classifyFn1. Подсистема МПП передает это значение в классifyFn водителя выноски.

[in] flags

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

[out] classifyHandle

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

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

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 7.
Целевая платформа Универсальное
Верхняя часть fwpsk.h (включая Fwpsk.h)
Библиотека Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

См. также раздел

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classifyFn1