Funzione FwpmEngineOpen0 (fwpmk.h)

Articolo
08/07/2023

La funzione FwpmEngineOpen0 apre una sessione al motore di filtro.

Nota

FwpmEngineOpen0 è una versione specifica di FwpmEngineOpen. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Sintassi

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

Parametri

[in, optional] serverName

Puntatore a una stringa con terminazione NULL che specifica il nome DNS standard del sistema in cui viene aperta la sessione al motore di filtro. I driver di callout devono specificare NULL per questo parametro.

[in] authnService

Servizio di autenticazione da usare. Per un elenco di scelte valide per questo parametro, vedere Authentication-Service Costanti nella sezione RPC nella documentazione di Microsoft Windows SDK. I driver di callout devono specificare RPC_C_AUTHN_WINNT o RPC_C_AUTHN_DEFAULT per questo parametro.

[in, optional] authIdentity

Puntatore a una struttura SEC_WINNT_AUTH_IDENTITY_W che contiene le credenziali di autenticazione e autorizzazione per l'accesso al motore di filtro. Questo parametro viene ignorato quando la funzione FwpmEngineOpen0 viene chiamata da un driver di callout. I driver callout devono impostare questo parametro su NULL.

[in, optional] session

Puntatore a una struttura FWPM_SESSION0 che definisce i parametri specifici della sessione per la sessione da aprire. Questo puntatore è facoltativo e può essere NULL.

[out] engineHandle

Puntatore a una variabile che riceve un handle per la sessione aperta al motore di filtro.

Valore restituito

La funzione FwpmEngineOpen0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	È stata aperta una sessione per il motore di filtro. La variabile a cui punta il parametro engineHandle contiene un handle per la sessione aperta.
Altri codici di stato	Si è verificato un errore.

Commenti

Un driver callout chiama la funzione FwpmEngineOpen0 per aprire una sessione al motore di filtro. Un handle per una sessione aperta per il motore di filtro è un parametro obbligatorio per la maggior parte delle funzioni di gestione di Windows Filtering Platform.

I driver di callout in genere non devono aprire una sessione al motore di filtro perché i driver di callout in genere non chiamano alcuna delle funzioni di gestione di Windows Filtering Platform .

Per consentire a un driver di callout di aprire correttamente una sessione al motore di filtro, il motore di filtro deve essere attualmente in esecuzione al momento in cui il driver del callout chiama la funzione FwpmEngineOpen0 . Un driver di callout può chiamare la funzione FwpmBfeStateGet0 per ottenere lo stato corrente del motore di filtro. Prima di chiamare FwpmBfeStateGet0, il driver callout deve chiamare la funzione FwpmBfeStateSubscribeChanges0 per registrare una funzione di callback che verrà chiamata ogni volta che si verifica una modifica nello stato del motore di filtro.

Al termine dell'accesso al motore di filtro, un driver callout chiama la funzione FwpmEngineClose0 per chiudere la sessione aperta al motore di filtro.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows Vista.
Piattaforma di destinazione	Universale
Intestazione	fwpmk.h (include Fwpmk.h)
Libreria	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL