estrutura FWPM_SESSION0 (fwpmtypes.h)

  • Artigo

A estrutura FWPM_SESSION0 armazena o estado associado a uma sessão de cliente.

Sintaxe

typedef struct FWPM_SESSION0_ {
  GUID               sessionKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  UINT32             txnWaitTimeoutInMSec;
  DWORD              processId;
  SID                *sid;
  wchar_t            *username;
  BOOL               kernelMode;
} FWPM_SESSION0;

Membros

sessionKey

Identifica exclusivamente a sessão.

Se esse membro for zero na chamada para FwpmEngineOpen0, o BFE (Mecanismo de Filtragem Base) gerará um GUID.

displayData

Permite que as sessões sejam anotadas em uma forma legível por humanos.

Consulte FWPM_DISPLAY_DATA0 para obter mais informações.

flags

Configurações para controlar o comportamento da sessão.

Sinalizador de sessão Significado
FWPM_SESSION_FLAG_DYNAMIC
 Quando esse sinalizador é definido, todos os objetos adicionados durante a sessão são excluídos automaticamente quando a sessão termina.
FWPM_SESSION_FLAG_RESERVED
 Reservado.

txnWaitTimeoutInMSec

Tempo em mil segundos que um cliente aguardará para iniciar uma transação.

Se esse membro for zero, a BFE usará um tempo limite padrão.

processId

ID do processo do cliente.

sid

SID do cliente.

username

Nome de usuário do cliente.

kernelMode

TRUE se esse for um cliente no modo kernel.

Comentários

Essa estrutura contém informações fornecidas pelo cliente ao criar uma sessão chamando FwpmEngineOpen0 ou informações recuperadas do sistema ao enumerar sessões chamando FwpmSessionEnum0.

Os membros processId, sid, username e kernelMode não são fornecidos pelo cliente. Eles são fornecidos pelo BFE e podem ser recuperados ao enumerar sessões.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho fwpmtypes.h

Confira também

FWPM_DISPLAY_DATA0

FwpmEngineOpen0

FwpmSessionEnum0

Estruturas de API da Plataforma de Filtragem do Windows