Öffnen einer Sitzung für die Filter-Engine

Ein Legendentreiber muss eine Sitzung für die Filter-Engine öffnen, um Verwaltungsaufgaben wie das Hinzufügen von Filtern zur Filter-Engine auszuführen. Ein Legendentreiber öffnet eine Sitzung für die Filter-Engine, indem die Funktion FwpmEngineOpen0 aufgerufen wird. Beispiel:

HANDLE engineHandle;
NTSTATUS status;

// Open a session to the filter engine
status =
 FwpmEngineOpen0(
    NULL,              // The filter engine on the local system
    RPC_C_AUTHN_WINNT, // Use the Windows authentication service
    NULL,              // Use the calling thread's credentials
    NULL,              // There are no session-specific parameters
    &engineHandle      // Pointer to a variable to receive the handle
    );

Nachdem ein Legendentreiber erfolgreich eine Sitzung für die Filter-Engine geöffnet hat, kann er das zurückgegebene Handle verwenden, um die anderen Verwaltungsfunktionen der Windows-Filterplattform aufzurufen.