NCryptNotifyChangeKey-Funktion (ncrypt.h)

Artikel
02/29/2024

Die NCryptNotifyChangeKey-Funktion erstellt oder entfernt eine Schlüsseländerungsbenachrichtigung.

Das von dieser Funktion bereitgestellte Handle ist dasselbe Handle, das von der FindFirstChangeNotification-Funktion zurückgegeben wird. Sie verwenden die Wartefunktionen , um zu warten, bis das Benachrichtigungshandle signalisiert wird.

Syntax

SECURITY_STATUS NCryptNotifyChangeKey(
  [in]      NCRYPT_PROV_HANDLE hProvider,
  [in, out] HANDLE             *phEvent,
  [in]      DWORD              dwFlags
);

Parameter

[in] hProvider

Das Handle des Schlüsselspeicheranbieters. Dieses Handle wird mithilfe der Funktion NCryptOpenStorageProvider abgerufen.

[in, out] phEvent

Die Adresse einer HANDLE-Variablen , die entweder das Schlüsseländerungsbenachrichtigungsereignishandle empfängt oder enthält. Dies ist das gleiche Handle, das von der FindFirstChangeNotification-Funktion zurückgegeben wird. Weitere Informationen finden Sie in der DwFlags-Parameterbeschreibung .

[in] dwFlags

Eine Reihe von Flags, die das Verhalten dieser Funktion ändern. Dieser Parameter enthält eine Kombination aus mindestens einem der folgenden Werte.

Wert	Bedeutung
NCRYPT_REGISTER_NOTIFY_FLAG 0x00000001	Erstellen Sie eine neue Änderungsbenachrichtigung. Der parameter phEvent empfängt das Benachrichtigungshandle zur Schlüsseländerung.
NCRYPT_UNREGISTER_NOTIFY_FLAG 0x00000002	Entfernen Sie eine vorhandene Änderungsbenachrichtigung. Der parameter phEvent muss ein gültiges Schlüsseländerungsbenachrichtigungshandle enthalten. Dieses Handle ist nicht mehr gültig, nachdem diese Funktion mit diesem Flag aufgerufen wurde und der INVALID_HANDLE_VALUE Wert in diesem Handle platziert wird.
NCRYPT_MACHINE_KEY_FLAG 0x00000020	Erhalten Sie Änderungsbenachrichtigungen für Schlüssel im Computerschlüsselspeicher. Wenn dieses Flag nicht angegeben ist, treten die Änderungsbenachrichtigungsereignisse nur für Schlüssel im Schlüsselspeicher des aufrufenden Benutzers auf. Dieses Flag ist nur gültig, wenn es mit dem NCRYPT_REGISTER_NOTIFY_FLAG-Flag kombiniert wird.

Rückgabewert

Gibt einen status Code zurück, der den Erfolg oder Fehler der Funktion angibt.

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Funktion war erfolgreich.
NTE_BAD_FLAGS	Der dwFlags-Parameter enthält einen wert, der ungültig ist.
NTE_INVALID_HANDLE	Der hProvider-Parameter ist ungültig.
NTE_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.

Hinweise

Ein Dienst darf diese Funktion nicht über seine StartService-Funktion aufrufen. Wenn ein Dienst diese Funktion über seine StartService-Funktion aufruft, kann ein Deadlock auftreten, und der Dienst reagiert möglicherweise nicht mehr.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ncrypt.h
Bibliothek	Ncrypt.lib
DLL	Ncrypt.dll

Weitere Informationen

FindFirstChangeNotification

Freigeben über