Condividi tramite

Funzione FwpmProviderContextGetByKey1 (fwpmk.h)

  • Articolo

La funzione FwpmProviderContextGetByKey1 recupera un contesto del provider.

Sintassi

NTSTATUS FwpmProviderContextGetByKey1(
  [in] HANDLE                 engineHandle,
       const GUID             *key,
       FWPM_PROVIDER_CONTEXT1 **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 FwpmProviderContextAdd1 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: