Funzione NCryptNotifyChangeKey (ncrypt.h)

Articolo
03/05/2024

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

Condividi tramite