Funzione NCryptNotifyChangeKey (ncrypt.h)
La funzione NCryptNotifyChangeKey crea o rimuove una notifica di modifica della chiave.
L'handle fornito da questa funzione è lo stesso handle restituito dalla funzione FindFirstChangeNotification . Usare le funzioni di attesa per attendere che l'handle di notifica venga segnalato.
Sintassi
SECURITY_STATUS NCryptNotifyChangeKey(
[in] NCRYPT_PROV_HANDLE hProvider,
[in, out] HANDLE *phEvent,
[in] DWORD dwFlags
);
Parametri
[in] hProvider
Handle del provider di archiviazione delle chiavi. Questo handle viene ottenuto usando la funzione NCryptOpenStorageProvider .
[in, out] phEvent
Indirizzo di una variabile HANDLE che riceve o contiene l'handle dell'evento di notifica delle modifiche della chiave. Si tratta dello stesso handle restituito dalla funzione FindFirstChangeNotification . Per altre informazioni, vedere la descrizione del parametro dwFlags .
[in] dwFlags
Set di flag che modificano il comportamento di questa funzione. Questo parametro contiene una combinazione di uno o più dei valori seguenti.
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 dwFlags contiene un valore non valido. |
|
Il parametro hProvider non è valido. |
|
Uno o più parametri non sono validi. |
Commenti
Un servizio non deve chiamare questa funzione dalla funzione StartService. Se un servizio chiama questa funzione dalla funzione StartService, può verificarsi un deadlock e il servizio potrebbe smettere di rispondere.
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 | ncrypt.h |
Libreria | Ncrypt.lib |
DLL | Ncrypt.dll |