FwpsAcquireClassifyHandle0, fonction (fwpsk.h)

La fonction FwpsAcquireClassifyHandle0 génère un handle de classification utilisé pour identifier les opérations de classification asynchrones et les demandes de données de couche accessibles en écriture.

RemarqueFwpsAcquireClassifyHandle0 est une version spécifique de FwpsAcquireClassifyHandle. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

 

Syntaxe

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

Paramètres

[in] classifyContext

Paramètre classifyContext de classifyFn1. Le moteur PAM transmet cette valeur au classFn du pilote de légende.

[in] flags

Réservé pour un usage futur. Définit la valeur 0.

[out] classifyHandle

Pointeur vers une variable qui reçoit un handle de classification. Ce handle est nécessaire pour les appels de fonction suivants, comme indiqué dans Remarques.

Valeur retournée

La fonction FwpsAcquireClassifyHandle0 retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	Un handle de la demande de classification a été retourné avec succès. La variable vers laquelle pointe le paramètre classifyHandle contient le handle de la demande de classification.
Autres codes status	Une erreur est survenue.

Remarques

FwpsAcquireClassifyHandle0 est une fonction de prise en charge pour la classification asynchrone et la modification des données. Le handle retourné par cette fonction est requis en tant que paramètre pour les fonctions suivantes :

• FwpsPendClassify0

• FwpsAcquireWritableLayerDataPointer0
• FwpsApplyModifiedLayerData0

• FwpsCompleteClassify0

• FwpsReleaseClassifyHandle0

Pour chaque appel à cette fonction, le pilote de légende doit appeler FwpsReleaseClassifyHandle0 pour libérer les ressources système associées au handle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 7.
Plateforme cible	Universal
En-tête	fwpsk.h (include Fwpsk.h)
Bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classifiFn1