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

Статья
02/26/2024

Функция FwpsNetBufferListRetrieveContext0 извлекает контекст, связанный со списком сетевого буфера, который был помечен в другом слое.

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

Синтаксис

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

Параметры

[in, out] netBufferList

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

[in] contextTag

Локальный уникальный идентификатор, полученный путем вызоваФункция FwpsNetBufferListGetTagForContext0. Это тег контекста, используемый при первоначальном вызове FwpsNetBufferListAssociateContext0.

[in] removeContext

Если этот параметр задан, FwpsNetBufferListRetrieveContext0 удалит связь контекста в дополнение к получению контекста.

[in] flags

Этот параметр зарезервирован для дальнейшего использования и имеет нулевое значение.

[out] context

Контекст, назначенный пакету драйвером выноски в первоначальном вызове FwpsNetBufferListAssociateContext0.

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

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

Код возврата	Описание
STATUS_SUCCESS	Связь прошла успешно.
Другие коды состояния	Произошла ошибка.

Требования

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

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

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST