FWPM_SESSION0 structure (fwpmtypes.h)

La structure FWPM_SESSION0 stocke l’état associé à une session cliente.

Syntaxe

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;

Membres

sessionKey

Identifie de manière unique la session.

Si ce membre est égal à zéro dans l’appel à FwpmEngineOpen0, le moteur de filtrage de base (BFE) génère un GUID.

displayData

Permet aux sessions d’être annotées sous une forme lisible par l’homme.

Pour plus d’informations, consultez FWPM_DISPLAY_DATA0 .

flags

Paramètres pour contrôler le comportement de la session.

Indicateur de session Signification
FWPM_SESSION_FLAG_DYNAMIC
Lorsque cet indicateur est défini, tous les objets ajoutés pendant la session sont automatiquement supprimés à la fin de la session.
FWPM_SESSION_FLAG_RESERVED
Réservé.

txnWaitTimeoutInMSec

Durée en milli secondes pendant laquelle un client attend pour commencer une transaction.

Si ce membre est égal à zéro, BFE utilise un délai d’expiration par défaut.

processId

ID de processus du client.

sid

SID du client.

username

Nom d’utilisateur du client.

kernelMode

TRUE s’il s’agit d’un client en mode noyau.

Remarques

Cette structure contient des informations fournies par le client lors de la création d’une session en appelant FwpmEngineOpen0, ou des informations récupérées du système lors de l’énumération de sessions en appelant FwpmSessionEnum0.

Les membres processId, sid, username et kernelMode ne sont pas fournis par le client. Ils sont fournis par BFE et peuvent être récupérés lors de l’énumération des sessions.

FWPM_SESSION0 est une implémentation spécifique de FWPM_SESSION. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête fwpmtypes.h

Voir aussi

FWPM_DISPLAY_DATA0

FwpmEngineOpen0

FwpmSessionEnum0

Structures de l’API de plateforme de filtrage Windows