BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify è deprecato a partire da Windows 10.]

La funzione BCryptRegisterConfigChangeNotify(PRKEVENT) crea il gestore eventi di modifica della configurazione CNG in modalità kernel.

Sintassi

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

Parametri

[in] phEvent

Indirizzo di una variabile PRKEVENT che riceve il puntatore all'oggetto dispatcher dell'evento. Usare le funzioni di attesa del kernel, ad esempio WaitForSingleObject, per determinare quando l'evento è stato segnalato. L'evento viene segnalato quando la configurazione CNG è stata modificata.

Questo handle deve essere passato alla funzione BCryptUnregisterConfigChangeNotify(PRKEVENT) 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). BCryptRegisterConfigChangeNotify(PRKEVENT) può essere chiamato solo in modalità kernel e in PASSIVE_LEVEL IRQL. Il codice in esecuzione in modalità utente deve chiamare BCryptRegisterConfigChangeNotify(HANDLE*).

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Intestazione bcrypt.h

Vedi anche

Funzione BCryptUnregisterConfigChangeNotify(PRKEVENT)