Función BCryptRegisterConfigChangeNotify (bcrypt.h)

  • Artículo

[BCryptRegisterConfigChangeNotify está en desuso a partir de Windows 10.]

La función BCryptRegisterConfigChangeNotify(HANDLE*) crea un controlador de eventos de cambio de configuración CNG en modo de usuario.

Sintaxis

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

Parámetros

[out] pEvent

Dirección de una variable HANDLE que recibe el identificador de eventos. Use una de las funciones Wait, como WaitForSingleObject, para determinar cuándo se ha señalado el evento. El evento no tiene nombre y debe ser un evento de restablecimiento manual. El evento se señala cuando se han cambiado los datos de configuración de CNG.

Este identificador debe pasarse a la función BCryptUnregisterConfigChangeNotify(HANDLE) para quitar la notificación de eventos.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Entre los posibles códigos de retorno se incluyen, entre otros, los siguientes.

Código devuelto Descripción
STATUS_SUCCESS
 La función se realizó correctamente.
STATUS_INVALID_PARAMETER
 El parámetro phEvent no es válido.
STATUS_NO_MEMORY
 Error de asignación de memoria.

Comentarios

El identificador devuelto en la variable a la que apunta el parámetro phEvent se indicará cuando se produzca un cambio en la configuración de CNG.

Solo se puede llamar a BCryptRegisterConfigChangeNotify(HANDLE*) en modo de usuario. El código que se ejecuta en modo kernel debe llamar a BCryptRegisterConfigChangeNotify(PRKEVENT).

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado bcrypt.h
Library Bcrypt.lib
Archivo DLL Bcrypt.dll

Consulte también

BCryptUnregisterConfigChangeNotify(HANDLE)