Funzione BCryptRegisterConfigChangeNotify (bcrypt.h)
[BCryptRegisterConfigChangeNotify è deprecato a partire da Windows 10.]
La funzione BCryptRegisterConfigChangeNotify(HANDLE*) crea un gestore eventi di modifica della configurazione CNG in modalità utente.
Sintassi
NTSTATUS BCryptRegisterConfigChangeNotify(
[out] PRKEVENT pEvent
);
Parametri
[out] pEvent
Indirizzo di una variabile HANDLE che riceve l'handle dell'evento. Usare una delle funzioni wait, ad esempio WaitForSingleObject, per determinare quando l'evento è stato segnalato. L'evento è senza nome e deve essere un evento di reimpostazione manuale. L'evento viene segnalato quando vengono modificati i dati di configurazione CNG.
Questo handle deve essere passato alla funzione BCryptUnregisterConfigChangeNotify(HANDLE) per rimuovere la notifica degli eventi.
Valore restituito
Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.
I codici restituiti possibili includono, a titolo esemplificativo, quanto segue.
Codice restituito | Descrizione |
---|---|
|
La funzione ha avuto esito positivo. |
|
Il parametro phEvent non è valido. |
|
Si è verificato un errore di allocazione della memoria. |
Commenti
L'handle restituito nella variabile a cui punta il parametro phEvent verrà segnalato quando si verifica una modifica alla configurazione CNG.
BCryptRegisterConfigChangeNotify(HANDLE*) può essere chiamato solo in modalità utente. Il codice in esecuzione in modalità kernel deve chiamare BCryptRegisterConfigChangeNotify(PRKEVENT).
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | bcrypt.h |
Libreria | Bcrypt.lib |
DLL | Bcrypt.dll |