BCryptRegisterConfigChangeNotify

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

A função BCryptRegisterConfigChangeNotify(PRKEVENT) cria o manipulador de eventos de alteração de configuração CNG do modo kernel.

Sintaxe

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

Parâmetros

[in] phEvent

O endereço de uma variável PRKEVENT que recebe o ponteiro para o objeto dispatcher de eventos. Use as funções de espera do kernel, como WaitForSingleObject, para determinar quando o evento foi sinalizado. O evento é sinalizado quando a configuração do CNG é alterada.

Esse identificador deve ser passado para a função BCryptUnregisterConfigChangeNotify(PRKEVENT) 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). BCryptRegisterConfigChangeNotify(PRKEVENT) só pode ser chamado no modo kernel e em PASSIVE_LEVEL IRQL. O código em execução no modo de usuário deve chamar BCryptRegisterConfigChangeNotify(HANDLE*).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 Build 20348
Servidor mínimo com suporte	Windows 10 Build 20348
Cabeçalho	bcrypt.h

Confira também

Função BCryptUnregisterConfigChangeNotify(PRKEVENT)