BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify ist ab Windows 10 veraltet.]

Die Funktion BCryptRegisterConfigChangeNotify(PRKEVENT) erstellt den CNG-Konfigurationsänderungsereignishandler im Kernelmodus.

Syntax

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

Parameter

[in] phEvent

Die Adresse einer PRKEVENT-Variablen , die den Zeiger auf das Ereignisverteilerobjekt empfängt. Sie verwenden die Kernelwartefunktionen, z . B. WaitForSingleObject, um zu bestimmen, wann das Ereignis signalisiert wurde. Das Ereignis wird signalisiert, wenn sich die CNG-Konfiguration geändert hat.

Dieses Handle muss an die Funktion BCryptUnregisterConfigChangeNotify(PRKEVENT) übergeben werden, um die Ereignisbenachrichtigung zu entfernen.

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
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_INVALID_PARAMETER	Der phEvent-Parameter ist ungültig.
STATUS_NO_MEMORY	Ein Fehler bei der Speicherzuordnung ist aufgetreten.

Hinweise

Das Handle, das in der Variablen zurückgegeben wird, auf die der parameter phEvent verweist, wird signalisiert, wenn eine Änderung an der CNG-Konfiguration auftritt.

BCryptRegisterConfigChangeNotify(HANDLE*) kann nur im Benutzermodus aufgerufen werden. Code, der im Kernelmodus ausgeführt wird, muss BCryptRegisterConfigChangeNotify(PRKEVENT) aufrufen. BCryptRegisterConfigChangeNotify(PRKEVENT) kann nur im Kernelmodus und bei PASSIVE_LEVEL IRQL aufgerufen werden. Code, der im Benutzermodus ausgeführt wird, muss BCryptRegisterConfigChangeNotify(HANDLE*) aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Kopfzeile	bcrypt.h

Weitere Informationen

BCryptUnregisterConfigChangeNotify(PRKEVENT)-Funktion