Compartilhar via


BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify foi preterido a partir do 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 do 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 de CNG é alterada.

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

Valor de retorno

Retorna um código de 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 Description
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.

Observações

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

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

Requirements

Requirement Value
Cliente mínimo suportado Windows 10 Build 20348
Servidor mínimo compatível Windows 10 Build 20348
Header bcrypt.h
Library bcrypt.lib

Consulte também

Função BCryptUnregisterConfigChangeNotify(PRKEVENT)