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 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 |
---|---|
|
La fonction a réussi. |
|
Le paramètre dwFlags contient une valeur qui n’est pas valide. |
|
Le paramètre hProvider n’est pas valide. |
|
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 |