BCryptRegisterConfigChangeNotify, fonction (bcrypt.h)

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

La fonction BCryptRegisterConfigChangeNotify(HANDLE*) crée un gestionnaire d’événements de modification de configuration CNG en mode utilisateur.

Syntaxe

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

Paramètres

[out] pEvent

Adresse d’une variable HANDLE qui reçoit le handle d’événement. Utilisez l’une des fonctions d’attente, comme WaitForSingleObject, pour déterminer quand l’événement a été signalé. L’événement n’est pas nommé et doit être un événement de réinitialisation manuelle. L’événement est signalé quand les données de configuration du GNC ont changé.

Ce handle doit être passé à la fonction BCryptUnregisterConfigChangeNotify(HANDLE) 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 pointée par 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).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	bcrypt.h
Bibliothèque	Bcrypt.lib
DLL	Bcrypt.dll

Voir aussi

BCryptUnregisterConfigChangeNotify(HANDLE)