Funzione FwpmEngineOpen0 (fwpmk.h)

  • Articolo

La funzione FwpmEngineOpen0 apre una sessione al motore di filtro.

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 callout devono specificare NULL per questo parametro.

[in] authnService

Servizio di autenticazione da usare. Per un elenco delle opzioni valide per questo parametro, vedere Authentication-Service Costanti nella sezione RPC nella documentazione di Microsoft Windows SDK. I driver 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 viene chiamata la funzione FwpmEngineOpen0 da un driver 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 NTSTATUS Si è verificato un errore.

Osservazioni

Un driver callout chiama la funzione fwpmEngineOpen0 per aprire una sessione al motore di filtro. Un handle per una sessione aperta al motore di filtro è un parametro obbligatorio per la maggior parte delle funzioni di gestione della piattaforma di filtro Windows .

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

Per consentire a un driver 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 callout chiama la funzione FwpmEngineOpen0. Un driver callout può chiamare la funzione FwpmBfeStateGet0 per ottenere lo stato corrente del motore di filtro. Prima di chiamare FwpmBfeStateGet0, il driver del callout deve chiamare la funzione FwpmBfeStateSubscribeChanges0 per registrare una funzione di callback che verrà chiamata ogni volta che si verifica una modifica dello 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.

FwpmEngineOpen0 è una versione specifica di FwpmEngineOpen. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Fabbisogno

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

Vedere anche