Funzione BCryptRegisterConfigChangeNotify (bcrypt.h)

  • Articolo

[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
STATUS_SUCCESS
 La funzione ha avuto esito positivo.
STATUS_INVALID_PARAMETER
 Il parametro phEvent non è valido.
STATUS_NO_MEMORY
 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

Vedi anche

BCryptUnregisterConfigChangeNotify(HANDLE)