Função NCryptNotifyChangeKey (ncrypt.h)

  • Artigo

A função NCryptNotifyChangeKey cria ou remove uma notificação de alteração de chave.

O identificador fornecido por essa função é o mesmo identificador retornado pela função FindFirstChangeNotification . Use as funções de espera para aguardar a sinalização do identificador de notificação.

Sintaxe

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

Parâmetros

[in] hProvider

O identificador do provedor de armazenamento de chaves. Esse identificador é obtido usando a função NCryptOpenStorageProvider .

[in, out] phEvent

O endereço de uma variável HANDLE que recebe ou contém o identificador de evento de notificação de alteração de chave. Esse é o mesmo identificador retornado pela função FindFirstChangeNotification . Para obter mais informações, consulte a descrição do parâmetro dwFlags .

[in] dwFlags

Um conjunto de sinalizadores que modificam o comportamento dessa função. Esse parâmetro contém uma combinação de um ou mais dos valores a seguir.

Valor Significado
NCRYPT_REGISTER_NOTIFY_FLAG
0x00000001
 Crie uma nova notificação de alteração. O parâmetro phEvent receberá o identificador de notificação de alteração de chave.
NCRYPT_UNREGISTER_NOTIFY_FLAG
0x00000002
 Remova uma notificação de alteração existente. O parâmetro phEvent deve conter um identificador de notificação de alteração de chave válido. Esse identificador não é mais válido depois que essa função é chamada com esse sinalizador e o valor INVALID_HANDLE_VALUE é colocado nesse identificador.
NCRYPT_MACHINE_KEY_FLAG
0x00000020
 Receber notificações de alteração para chaves no repositório de chaves do computador. Se esse sinalizador não for especificado, os eventos de notificação de alteração ocorrerão apenas para chaves no repositório de chaves do usuário de chamada. Esse sinalizador só é válido quando combinado com o sinalizador NCRYPT_REGISTER_NOTIFY_FLAG .

Retornar valor

Retorna um código status que indica o êxito ou a falha da função.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno Descrição
ERROR_SUCCESS
 A função foi bem-sucedida.
NTE_BAD_FLAGS
 O parâmetro dwFlags contém um valor que não é válido.
NTE_INVALID_HANDLE
 O parâmetro hProvider não é válido.
NTE_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.

Comentários

Um serviço não deve chamar essa função de sua Função StartService. Se um serviço chamar essa função de sua função StartService, um deadlock poderá ocorrer e o serviço poderá parar de responder.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ncrypt.h
Biblioteca Ncrypt.lib
DLL Ncrypt.dll

Confira também

FindFirstChangeNotification