Função FwpsQueryPacketInjectionState0 (fwpsk.h)
A função FwpsQueryPacketInjectionState0 é chamada por um texto explicativo para consultar o estado de injeção dos dados do pacote.
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 de NET_BUFFER_LIST que descreve os dados de 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.
Valor de retorno
A função FwpsQueryPacketInjectionState0 retorna um dos valores constantes da enumeração FWPS_PACKET_INJECTION_STATE.
Observações
Como os dados de pacote injetados podem ser reclassificados no texto explicativo que os injetou, essa função permite que um texto explicativo inspecione o histórico de injeção de dados do pacote quando necessário, evitando assim a necessidade de fazer inspeções repetidas de dados de pacote 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 do 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 actionType membro da estrutura FWPS_CLASSIFY_OUT0 apontada pelo parâmetro classifyOut da função classifyFn para FWP_ACTION_CONTINUE ou FWP_ACTION_PERMIT. Isso permite que o pacote prossiga para o próximo texto explicativo.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows Vista. |
| da Plataforma de Destino | Universal |
| cabeçalho | fwpsk.h (inclua Fwpsk.h) |
| biblioteca | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |