Funzione FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

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

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 classifyFn funzione di filtro . Per altre informazioni sul membro FilterId, vedere FWPS_FILTER1.

[in] flags

Riservato per uso futuro. Impostare su zero.

[out] writableLayerData

Buffer di dati che contiene i dati modificabili per il livello. I tipi di dati supportati, elencati nella sezione Osservazioni seguenti, sono definiti come strutture. In caso di restituzione, è possibile accedere ai dati eseguendo il cast del puntatore void al tipo di struttura appropriato.

[in, out] classifyOut

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

Valore restituito

La funzione FwpsAcquireWritableLayerDataPointer0 restituisce uno dei codici NTSTATUS seguenti.

Osservazioni

FwpsAcquireWritableLayerDataPointer0 imposta i membri seguenti della struttura FWPS_CLASSIFY_OUT0:

• classifyOut->actionType = FWP_ACTION_BLOCK
• classifyOut->rights &= ~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 del callout non ha modificato alcun dato. Se non si effettua la chiamata a FwpsApplyModifiedLayerData0, è possibile che la classificazione non venga completata correttamente.

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

• FWPS_BIND_REQUEST0

• FWPS_CONNECT_REQUEST0

Fabbisogno

Vedere anche

FWPS_BIND_REQUEST0

FWPS_CLASSIFY_OUT0

FWPS_CONNECT_REQUEST0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsApplyModifiedLayerData0

FwpsReleaseClassifyHandle0

classificareFn