Share via

Función NCryptNotifyChangeKey (ncrypt.h)

  • Artículo

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