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 |
|---|---|
|
A função foi bem-sucedida. |
|
O parâmetro phEvent não é válido. |
|
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 |