BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify est déconseillé à partir de Windows 10.]

La fonction BCryptRegisterConfigChangeNotify(PRKEVENT) crée le gestionnaire d’événements de modification de configuration CNG en mode noyau.

Syntaxe

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

Paramètres

[in] phEvent

Adresse d’une variable PRKEVENT qui reçoit le pointeur vers l’objet de répartiteur d’événements. Vous utilisez les fonctions d’attente du noyau, telles que WaitForSingleObject, pour déterminer quand l’événement a été signalé. L’événement est signalé lorsque la configuration CNG a changé.

Ce handle doit être passé à la fonction BCryptUnregisterConfigChangeNotify(PRKEVENT) pour supprimer la notification d’événement.

Valeur retournée

Retourne un code status qui indique la réussite ou l’échec de la fonction.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_INVALID_PARAMETER	Le paramètre phEvent n’est pas valide.
STATUS_NO_MEMORY	Un échec d’allocation de mémoire s’est produit.

Remarques

Le handle retourné dans la variable vers laquelle pointe le paramètre phEvent est signalé lorsqu’une modification de la configuration CNG se produit.

BCryptRegisterConfigChangeNotify(HANDLE*) peut être appelé uniquement en mode utilisateur. Le code s’exécutant en mode noyau doit appeler BCryptRegisterConfigChangeNotify(PRKEVENT). BCryptRegisterConfigChangeNotify(PRKEVENT) peut être appelé uniquement en mode noyau et à PASSIVE_LEVEL IRQL. Le code s’exécutant en mode utilisateur doit appeler BCryptRegisterConfigChangeNotify(HANDLE*).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	bcrypt.h

Voir aussi

Fonction BCryptUnregisterConfigChangeNotify(PRKEVENT)