FWPM_SESSION0-Struktur (fwpmtypes.h)

Artikel
02/26/2024

Die FWPM_SESSION0-Struktur speichert den Zustand, der einer Clientsitzung zugeordnet ist.

Syntax

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;

Member

sessionKey

Identifiziert die Sitzung eindeutig.

Wenn dieses Element im Aufruf von FwpmEngineOpen0 null ist, generiert die Basisfilter-Engine (BFE) eine GUID.

displayData

Ermöglicht das Kommentieren von Sitzungen in einer lesbaren Form.

Weitere Informationen finden Sie unter FWPM_DISPLAY_DATA0 .

flags

Einstellungen zum Steuern des Sitzungsverhaltens.

Sitzungsflagge	Bedeutung
FWPM_SESSION_FLAG_DYNAMIC	Wenn dieses Flag festgelegt ist, werden alle Objekte, die während der Sitzung hinzugefügt wurden, automatisch gelöscht, wenn die Sitzung endet.
FWPM_SESSION_FLAG_RESERVED	Reserviert.

txnWaitTimeoutInMSec

Zeit in Milli-Sekunden, die ein Client wartet, um eine Transaktion zu beginnen.

Wenn dieser Member 0 ist, verwendet BFE ein Standardtimeout.

processId

Prozess-ID des Clients.

sid

SID des Clients.

username

Benutzername des Clients.

kernelMode

TRUE, wenn es sich um einen Client im Kernelmodus handelt.

Hinweise

Diese Struktur enthält Informationen, die vom Client beim Erstellen einer Sitzung durch Aufrufen von FwpmEngineOpen0 bereitgestellt werden, oder Informationen, die beim Auflisten von Sitzungen durch Aufrufen von FwpmSessionEnum0 vom System abgerufen werden.

Die Member processId, sid, username und kernelMode werden nicht vom Client bereitgestellt. Sie werden von BFE bereitgestellt und können beim Aufzählen von Sitzungen abgerufen werden.

FWPM_SESSION0 ist eine spezifische Implementierung von FWPM_SESSION. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	fwpmtypes.h

Weitere Informationen

FWPM_DISPLAY_DATA0

FwpmEngineOpen0

FwpmSessionEnum0

API-Strukturen der Windows-Filterplattform

Freigeben über