Funzione FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

Articolo
02/26/2024

La funzione FwpsAcquireWritableLayerDataPointer0 restituisce dati specifici del livello che possono essere controllati e modificati.

NotaFwpsAcquireWritableLayerDataPointer0 è una versione specifica di FwpsAcquireWritableLayerDataPointer. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

Sintassi

NTSTATUS FwpsAcquireWritableLayerDataPointer0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [out]     PVOID              *writableLayerData,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Parametri

[in] classifyHandle

Handle per la richiesta di classificazione. Questo handle viene ottenuto chiamando FwpsAcquireClassifyHandle0.

[in] filterId

Valore del membro FilterId del parametro filterFn della funzione di classificazione. Per altre informazioni sul membro FilterId , vedere FWPS_FILTER1.

[in] flags

Riservato per utilizzi futuri. Imposta su zero.

[out] writableLayerData

Buffer di dati contenente i dati modificabili per il livello. I tipi di dati supportati, elencati nella sezione Osservazioni seguenti, sono definiti come strutture. In caso di restituzione, i dati possono essere accessibili eseguendo il cast del puntatore void al tipo di struttura appropriato.

[in, out] classifyOut

Impostare sul parametro di classificazioneOut della funzione classificazioneFn del driver di callout. Il parametro di classificazioneFn è elencato come parametro di output nell'intestazione, ma contiene informazioni sufficienti sull'input da usare per il motore quando viene passato a FwpsAcquireWritableLayerDataPointer0.

Valore restituito

La funzione FwpsAcquireWritableLayerDataPointer0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione di callback è stata registrata correttamente.
Altri codici di stato	Si è verificato un errore.

Commenti

FwpsAcquireWritableLayerDataPointer0 imposta i membri seguenti della struttura FWPS_CLASSIFY_OUT0 :

classificazioneOut->actionType = FWP_ACTION_BLOCK
classificazioneOut->diritti &= ~FWPS_RIGHT_ACTION_WRITE

Per ogni chiamata a questa funzione, è necessario effettuare una chiamata corrispondente a FwpsApplyModifiedLayerData0 per finalizzare le modifiche apportate, anche se il driver di callout non ha modificato alcun dato. Se non si effettua la chiamata a FwpsApplyModifiedLayerData0, ciò potrebbe comportare il completamento corretto della classificazione.

Le strutture seguenti sono definite per contenere dati di livello modificabili. Il puntatore impostato sull'output come parametro writableLayerData può essere eseguito il cast in uno di questi tipi:

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 7.
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (includere Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL