Journalisation des données

Pour déterminer quelles données doivent être journalisées, la fonction classifyFn d'un callout peut inspecter n'importe quelle combinaison des champs de données, des champs de métadonnées et des données brutes qui lui sont transmises, ainsi que les données pertinentes qui ont été stockées dans un contexte associé au filtre ou au flux de données.

Par exemple, si un appel suit le nombre de paquets IPv4 entrants rejetés par un filtre à la couche réseau, l'appel est ajouté au moteur de filtre à la couche FWPM_LAYER_INBOUND_IPPACKET_V4_DISCARD. Dans ce cas, la fonction callout classifyFn peut ressembler à l’exemple suivant :

ULONG TotalDiscardCount = 0;
ULONG FilterDiscardCount = 0;

// classifyFn callout function
VOID NTAPI
 ClassifyFn(
    IN const FWPS_INCOMING_VALUES0  *inFixedValues,
    IN const FWPS_INCOMING_METADATA_VALUES0  *inMetaValues,
    IN OUT VOID  *layerData,
    IN const FWPS_FILTER0  *filter,
    IN UINT64  flowContext,
    IN OUT FWPS_CLASSIFY_OUT  *classifyOut
    )
{
  // Increment the total count of discarded packets
 InterlockedIncrement(&TotalDiscardCount);


  // Check whether a discard reason metadata field is present
 if (FWPS_IS_METADATA_FIELD_PRESENT(
 inMetaValues,
        FWPS_METADATA_FIELD_DISCARD_REASON))
  {
    // Check whether it is a general discard reason
 if (inMetaValues->discardMetadata.discardModule ==
        FWPS_DISCARD_MODULE_GENERAL)
    {
      // Check whether discarded by a filter
 if (inMetaValues->discardMetadata.discardReason ==
          FWPS_DISCARD_FIREWALL_POLICY)
      {
        // Increment the count of packets discarded by a filter
 InterlockedIncrement(&FilterDiscardCount);
      }
    }
  }

  // Take no action on the data
 classifyOut->actionType = FWP_ACTION_CONTINUE;
}

Rubriques connexes

classifierFn