FwpsAcquireClassifyHandle0, fonction (fwpsk.h)

Article
02/07/2025

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 accessible en écriture.

RemarqueFwpsAcquireClassifyHandle0 est une version spécifique de FwpsAcquireClassifyHandle. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Syntaxe

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

Paramètres

[in] classifyContext

Paramètre classifiezContext de classifiezFn1. Le moteur DU PAM transmet cette valeur au classifie ledu pilote de légende.

[in] flags

Réservé pour une utilisation ultérieure. Défini sur 0.

[out] classifyHandle

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

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	Un handle de la demande de classification a été retourné avec succès. Variable que le classifieHandle points de paramètre pour contenir le handle de la demande de classification.
Autres codes d’état	Une erreur s’est produite.

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 comme paramètre pour les fonctions suivantes :

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

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 7.
plateforme cible	Universel
d’en-tête	fwpsk.h (include Fwpsk.h)
bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifierFn

classifierFn1

Partager via