BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify ist ab Windows 10 veraltet.]

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

Syntax

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

Die Parameter

[in] phEvent

Die Adresse einer PRKEVENT-Variablen , die den Zeiger auf das Ereignis dispatcher-Objekt empfängt. Sie verwenden die Kernel-Wait-Funktionen, 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 BCryptUnregisterConfigChangeNotify(PRKEVENT) -Funktion übergeben werden, um die Ereignisbenachrichtigung zu entfernen.

Rückgabewert

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

Mögliche Rückgabecodes umfassen, aber nicht beschränkt auf Folgendes.

Bemerkungen

Das handle, das in der Variablen zurückgegeben wird, auf die der phEvent-Parameter 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

Siehe auch

BCryptUnregisterConfigChangeNotify(PRKEVENT)-Funktion