Función NCryptNotifyChangeKey (ncrypt.h)

La función NCryptNotifyChangeKey crea o quita una notificación de cambio de clave.

El identificador proporcionado por esta función es el mismo identificador que devuelve la función FindFirstChangeNotification . Las funciones de espera se usan para esperar a que se señale el identificador de notificación.

Sintaxis

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

Parámetros

[in] hProvider

Identificador del proveedor de almacenamiento de claves. Este identificador se obtiene mediante la función NCryptOpenStorageProvider .

[in, out] phEvent

La dirección de una variable HANDLE que recibe o contiene el identificador de eventos de notificación de cambio de clave. Este es el mismo identificador que devuelve la función FindFirstChangeNotification . Para obtener más información, consulte la descripción del parámetro dwFlags .

[in] dwFlags

Conjunto de marcas que modifican el comportamiento de esta función. Este parámetro contiene una combinación de uno o varios de los valores siguientes.

Valor	Significado
NCRYPT_REGISTER_NOTIFY_FLAG 0x00000001	Cree una nueva notificación de cambio. El parámetro phEvent recibirá el identificador de notificación de cambio de clave.
NCRYPT_UNREGISTER_NOTIFY_FLAG 0x00000002	Quite una notificación de cambio existente. El parámetro phEvent debe contener un identificador de notificación de cambio de clave válido. Este identificador ya no es válido después de llamar a esta función con esta marca y el valor de INVALID_HANDLE_VALUE se coloca en este identificador.
NCRYPT_MACHINE_KEY_FLAG 0x00000020	Recibir notificaciones de cambio para las claves en el almacén de claves de la máquina. Si no se especifica esta marca, los eventos de notificación de cambio solo se producirán para las claves del almacén de claves del usuario que realiza la llamada. Esta marca solo es válida cuando se combina con la marca NCRYPT_REGISTER_NOTIFY_FLAG .

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
ERROR_SUCCESS	La función se realizó correctamente.
NTE_BAD_FLAGS	El parámetro dwFlags contiene un valor que no es válido.
NTE_INVALID_HANDLE	El parámetro hProvider no es válido.
NTE_INVALID_PARAMETER	Uno o más parámetros no son válidos.

Comentarios

Un servicio no debe llamar a esta función desde su función StartService. Si un servicio llama a esta función desde su función StartService, se puede producir un interbloqueo y el servicio puede dejar de responder.

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	ncrypt.h
Library	Ncrypt.lib
Archivo DLL	Ncrypt.dll

Consulte también

FindFirstChangeNotification