Funzione FwpmProviderContextGetByKey0 (fwpmk.h)

Articolo
07/16/2024

La funzione FwpmProviderContextGetByKey0 recupera un contesto del provider.

Sintassi

NTSTATUS FwpmProviderContextGetByKey0(
  [in] HANDLE                 engineHandle,
       const GUID             *key,
       FWPM_PROVIDER_CONTEXT0 **providerContext
);

Parametri

[in] engineHandle

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

key

Puntatore a un GUID che identifica in modo univoco il contesto del provider. Si tratta di un puntatore allo stesso GUID specificato quando l'applicazione ha chiamato FwpmProviderContextAdd0 per questo oggetto.

providerContext

Informazioni sul contesto del provider.

Valore restituito

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Il contesto del provider è stato recuperato correttamente.
*FWP_E_ codice di errore** 0x80320001: 0x80320039	Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere codici di errore WFP.
*RPC_ codice di errore** 0x80010001: 0x80010122	Errore di comunicazione con il motore firewall remoto o locale.
Altri codici NTSTATUS	Si è verificato un errore.

Osservazioni

Il chiamante deve liberare l'oggetto restituito da una chiamata a FwpmFreeMemory0.

Il chiamante deve FWPM_ACTRL_READ l'accesso al contesto del provider. Per altre informazioni, vedere di controllo di accesso.

FwpmProviderContextGetByKey0 è un'implementazione specifica di FwpmProviderContextGetByKey. 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
libreria	fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Vedere anche

Ecco tutti i collegamenti nel documento corrente:

Condividi tramite