Função FwpsQueryPacketInjectionState0 (fwpsk.h)

  • Artigo

A função FwpsQueryPacketInjectionState0 é chamada por um texto explicativo para consultar o estado de injeção de dados de pacote.

ObservaçãoFwpsQueryPacketInjectionState0 é uma versão específica de FwpsQueryPacketInjectionState. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
 

Sintaxe

FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
  [in]            HANDLE                injectionHandle,
  [in]            const NET_BUFFER_LIST *netBufferList,
  [out, optional] HANDLE                *injectionContext
);

Parâmetros

[in] injectionHandle

Um identificador de injeção que foi criado anteriormente por uma chamada para o Função FwpsInjectionHandleCreate0 .

[in] netBufferList

Um ponteiro para uma estrutura NET_BUFFER_LIST que descreve os dados do pacote que estão sendo classificados. O pacote pode ser originado da pilha de rede ou pode ser injetado na pilha de rede por um driver de texto explicativo WFP.

[out, optional] injectionContext

Um identificador opcional para o contexto de injeção. Se o ponteiro for especificado e se o estado de injeção de pacote FWPS_PACKET_INJECTION_STATE associado ao identificador de injeção for FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, o contexto de injeção fornecido quando o pacote foi injetado será retornado.

Retornar valor

A função FwpsQueryPacketInjectionState0 retorna um dos valores constantes da enumeração FWPS_PACKET_INJECTION_STATE .

Comentários

Como os dados de pacote injetados podem ser reclassificados em relação ao texto explicativo que os injetou, essa função permite que um texto explicativo inspecione o histórico de injeção de dados de pacote quando necessário, evitando assim a necessidade de fazer inspeções repetidas de dados de pacotes que já foram inspecionados.

Um texto explicativo pode acompanhar outras informações específicas do texto explicativo especificando o identificador injectionContext opcional em uma das funções de injeção de pacote no momento da injeção de dados de pacote. Se a função FwpsQueryPacketInjectionState0 retornar FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, o injectionContext fornecido será retornado como o parâmetro completionContext da função que executou a injeção.

Se o valor retornado for FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, a lista de buffers de rede apontada por netBufferList não deverá ser modificada ou pendente como parte de um procedimento de clonagem e injeção. Nesse caso, o texto explicativo deve definir o membro actionType da estrutura FWPS_CLASSIFY_OUT0 apontada pelo parâmetro classifyOut da função classifyFn como FWP_ACTION_CONTINUE ou FWP_ACTION_PERMIT. Isso permite que o pacote prossiga para o próximo texto explicativo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows Vista.
Plataforma de Destino Universal
Cabeçalho fwpsk.h (inclua Fwpsk.h)
Biblioteca Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

Confira também

FWPS_CLASSIFY_OUT0

FWPS_PACKET_INJECTION_STATE

FwpsInjectionHandleCreate0

NET_BUFFER_LIST

classifyFn