BCryptRegisterConfigChangeNotify-Funktion (bcrypt.h)

[BCryptRegisterConfigChangeNotify ist ab Windows 10 veraltet.]

Die Funktion BCryptRegisterConfigChangeNotify(HANDLE*) erstellt einen CNG-Konfigurationsänderungsereignishandler für den Benutzermodus.

Syntax

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

Parameter

[out] pEvent

Die Adresse einer HANDLE-Variablen , die das Ereignishandle empfängt. Verwenden Sie eine der Wartefunktionen, z . B. WaitForSingleObject, um zu bestimmen, wann das Ereignis signalisiert wurde. Das Ereignis ist unbenannt und muss ein manuelles Zurücksetzungsereignis sein. Das Ereignis wird signalisiert, wenn sich CNG-Konfigurationsdaten geändert haben.

Dieses Handle muss an die Funktion BCryptUnregisterConfigChangeNotify(HANDLE) ü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.

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.

Anforderungen

Weitere Informationen

BCryptUnregisterConfigChangeNotify(HANDLE)