Fonction NCryptNotifyChangeKey (ncrypt.h)

La fonction NCryptNotifyChangeKey crée ou supprime une notification de modification de clé.

Le handle fourni par cette fonction est le même handle que celui retourné par la fonction FindFirstChangeNotification . Vous utilisez les fonctions d’attente pour attendre que le handle de notification soit signalé.

Syntaxe

SECURITY_STATUS NCryptNotifyChangeKey(
  [in]      NCRYPT_PROV_HANDLE hProvider,
  [in, out] HANDLE             *phEvent,
  [in]      DWORD              dwFlags
);

Paramètres

[in] hProvider

Handle du fournisseur de stockage de clés. Ce handle est obtenu à l’aide de la fonction NCryptOpenStorageProvider .

[in, out] phEvent

Adresse d’une variable HANDLE qui reçoit ou contient le handle d’événement de notification de modification de clé. Il s’agit du même handle que celui retourné par la fonction FindFirstChangeNotification . Pour plus d’informations, consultez la description du paramètre dwFlags .

[in] dwFlags

Ensemble d’indicateurs qui modifient le comportement de cette fonction. Ce paramètre contient une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur Signification
NCRYPT_REGISTER_NOTIFY_FLAG
0x00000001
Créez une notification de modification. Le paramètre phEvent reçoit le handle de notification de modification de clé.
NCRYPT_UNREGISTER_NOTIFY_FLAG
0x00000002
Supprimez une notification de modification existante. Le paramètre phEvent doit contenir un handle de notification de modification de clé valide. Ce handle n’est plus valide une fois que cette fonction est appelée avec cet indicateur et que la valeur INVALID_HANDLE_VALUE est placée dans ce handle.
NCRYPT_MACHINE_KEY_FLAG
0x00000020
Recevez des notifications de modification pour les clés dans le magasin de clés de l’ordinateur. Si cet indicateur n’est pas spécifié, les événements de notification de modification se produisent uniquement pour les clés dans le magasin de clés de l’utilisateur appelant. Cet indicateur n’est valide qu’en cas de combinaison avec l’indicateur NCRYPT_REGISTER_NOTIFY_FLAG .

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
ERROR_SUCCESS
La fonction a réussi.
NTE_BAD_FLAGS
Le paramètre dwFlags contient une valeur qui n’est pas valide.
NTE_INVALID_HANDLE
Le paramètre hProvider n’est pas valide.
NTE_INVALID_PARAMETER
Un ou plusieurs paramètres ne sont pas valides.

Remarques

Un service ne doit pas appeler cette fonction à partir de sa fonction StartService. Si un service appelle cette fonction à partir de sa fonction StartService, un blocage peut se produire et le service peut cesser de répondre.

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 ncrypt.h
Bibliothèque Ncrypt.lib
DLL Ncrypt.dll

Voir aussi

FindFirstChangeNotification