Compartilhar via


Função BCryptRegisterConfigChangeNotify (bcrypt.h)

[BCryptRegisterConfigChangeNotify foi preterido começando com Windows 10.]

A função BCryptRegisterConfigChangeNotify(HANDLE*) cria um manipulador de eventos de alteração de configuração CNG no modo de usuário.

Sintaxe

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

Parâmetros

[out] pEvent

O endereço de uma variável HANDLE que recebe o identificador de evento. Use uma das funções de espera, como WaitForSingleObject, para determinar quando o evento foi sinalizado. O evento não tem nome e deve ser um evento de redefinição manual. O evento é sinalizado quando todos os dados de configuração de CNG são alterados.

Esse identificador deve ser passado para a função BCryptUnregisterConfigChangeNotify(HANDLE) para remover a notificação de evento.

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
STATUS_SUCCESS
A função foi bem-sucedida.
STATUS_INVALID_PARAMETER
O parâmetro phEvent não é válido.
STATUS_NO_MEMORY
Ocorreu uma falha de alocação de memória.

Comentários

O identificador retornado na variável apontada pelo parâmetro phEvent será sinalizado quando ocorrer uma alteração na configuração do CNG.

BCryptRegisterConfigChangeNotify(HANDLE*) só pode ser chamado no modo de usuário. O código em execução no modo kernel deve chamar BCryptRegisterConfigChangeNotify(PRKEVENT).

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 bcrypt.h
Biblioteca Bcrypt.lib
DLL Bcrypt.dll

Confira também

BCryptUnregisterConfigChangeNotify(HANDLE)