Функция FwpsQueryPacketInjectionState0 (fwpsk.h)
Функция FwpsQueryPacketInjectionState 0 вызывается выноской для запроса состояния внедрения данных пакета.
Синтаксис
FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
[in] HANDLE injectionHandle,
[in] const NET_BUFFER_LIST *netBufferList,
[out, optional] HANDLE *injectionContext
);
Параметры
[in] injectionHandle
Дескриптор внедрения, созданный ранее вызовом функцию FwpsInjectionHandleCreate0.
[in] netBufferList
Указатель на структуру NET_BUFFER_LIST, описывающую классифицируемые данные пакетов. Пакет может происходить из сетевого стека или его можно внедрить в сетевой стек драйвером выноски МПП.
[out, optional] injectionContext
Необязательный дескриптор контекста внедрения. Если указан указатель, а состояние внедрения пакета FWPS_PACKET_INJECTION_STATE, связанное с дескриптором внедрения, FWPS_PACKET_INJECTED_BY_SELF или FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, контекст внедрения, предоставленный при вводе пакета, будет возвращен.
Возвращаемое значение
Функция FwpsQueryPacketInjectionState 0 возвращает одно из константных значений перечисления FWPS_PACKET_INJECTION_STATE.
Замечания
Так как внедренные данные пакетов можно переклассифицировать на выноску, которая была введена, эта функция позволяет выноске проверять журнал данных пакета при необходимости, тем самым избегая повторяющихся проверок данных пакетов, которые уже были проверены.
Выноска может отслеживать другие сведения о выноске, указав необязательный внедренияcontext в одной из функций внедрения пакетов во время внедрения пакетов. Если функция FwpsQueryPacketInjectionState 0 возвращает FWPS_PACKET_INJECTED_BY_SELF или FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, предоставленный внедренияContext будет возвращен в качестве параметра завершенияContext функции, которая выполнила внедрение.
Если возвращаемое значение равно FWPS_PACKET_INJECTED_BY_SELF или FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, список буферов сети, указывающий на netBufferList, не следует изменять или подписывать в рамках процедуры клонирования и внедрения. В этом случае выноска должна задать элемент actionType структуры FWPS_CLASSIFY_OUT0, на который указывает параметр classifyOut функции classifyFn либо FWP_ACTION_CONTINUE, либо FWP_ACTION_PERMIT. Это позволяет пакету перейти к следующему выноске.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows Vista. |
| целевая платформа | Всеобщий |
| заголовка | fwpsk.h (include Fwpsk.h) |
| библиотеки | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |