FWPM_CALLOUT0 struttura (fwpmtypes.h)

Articolo
08/23/2023

La struttura FWPM_CALLOUT0 archivia lo stato associato a un callout.

Sintassi

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

Members

calloutKey

Identifica in modo univoco la sessione.

Se il GUID viene inizializzato su zero nella chiamata a FwpmCalloutAdd0, il motore di filtro di base (BFE) genererà uno.

displayData

Struttura FWPM_DISPLAY_DATA0 contenente annotazioni leggibili associate al callout. È necessario il membro del nome della struttura FWPM_DISPLAY_DATA0 .

flags

Valore	Significato
FWPM_CALLOUT_FLAG_PERSISTENT	Il callout è persistente tra i riavvii. Di conseguenza, può essere fatto riferimento all'ora di avvio e ad altri filtri persistenti.
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT	Il callout deve accedere al contesto del provider archiviato nel filtro che richiama il callout. Se questo flag è impostato, il contesto del provider verrà copiato dalla struttura [FWPM_FILTER0](/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0) alla struttura FWPS_FILTER0 . La struttura FWPS_FILTER0 è documentata in WDK.
FWPM_CALLOUT_FLAG_REGISTERED	Il callout è attualmente registrato nel kernel. Questo flag non deve essere impostato quando si aggiungono nuovi callout. Viene usato solo per eseguire query sullo stato dei callout esistenti.

providerKey

Identifica in modo univoco il provider associato al callout. Se il membro non è NULL, verranno restituiti solo gli oggetti associati al provider specificato.

providerData

Struttura FWP_BYTE_BLOB che contiene dati specifici del provider facoltativi che consente ai provider di archiviare informazioni di contesto aggiuntive con l'oggetto .

applicableLayer

Specifica il livello in cui è possibile usare il callout. Solo i filtri in questo livello possono richiamare il callout. Per altre informazioni, vedere Filtro degli identificatori di livello.

calloutId

LUID che identifica il callout. Questo è il calloutId archiviato nella struttura FWPS_ACTION0 per i filtri che richiamano un callout. La struttura FWPS_ACTION0 è documentata in WDK.

Commenti

I primi sei membri di questa struttura contengono dati forniti durante l'aggiunta di oggetti.

L'ultimo membro , calloutId, fornisce informazioni aggiuntive restituite durante l'acquisizione/enumerazione di oggetti.

FWPM_CALLOUT0 è un'implementazione specifica di FWPM_CALLOUT. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	fwpmtypes.h

Vedi anche

Strutture API della piattaforma di filtro di Windows

Condividi tramite