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 Significato
NCRYPT_REGISTER_NOTIFY_FLAG
0x00000001
Creare una nuova notifica di modifica. Il parametro phEvent riceverà l'handle di notifica della modifica della chiave.
NCRYPT_UNREGISTER_NOTIFY_FLAG
0x00000002
Rimuovere una notifica di modifica esistente. Il parametro phEvent deve contenere un handle di notifica di modifica della chiave valido. Questo handle non è più valido dopo la chiamata di questa funzione con questo flag e il valore INVALID_HANDLE_VALUE viene inserito in questo handle.
NCRYPT_MACHINE_KEY_FLAG
0x00000020
Ricevere notifiche di modifica per le chiavi nell'archivio chiavi del computer. Se questo flag non viene specificato, gli eventi di notifica delle modifiche si verificheranno solo per le chiavi nell'archivio chiavi dell'utente chiamante. Questo flag è valido solo se combinato con il flag NCRYPT_REGISTER_NOTIFY_FLAG .

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
ERROR_SUCCESS
La funzione ha avuto esito positivo.
NTE_BAD_FLAGS
Il parametro dwFlags contiene un valore non valido.
NTE_INVALID_HANDLE
Il parametro hProvider non è valido.
NTE_INVALID_PARAMETER
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

Vedi anche

FindFirstChangeNotification