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

Статья
02/07/2025

Функция 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	Ассоциация была успешной.
Другие коды состояния	Произошла ошибка.

Замечания

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

Эту функцию можно также использовать для удаления связи контекста, задав параметр removeContext.

Требования

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

См. также

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST

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