Função CmUnRegisterCallback (wdm.h)
A rotina CmUnRegisterCallback cancela o registro de uma rotina de RegistryCallback que uma rotina CmRegisterCallback ou CmRegisterCallbackEx registrada anteriormente.
Sintaxe
NTSTATUS CmUnRegisterCallback(
[in] LARGE_INTEGER Cookie
);
Parâmetros
[in] Cookie
Um valor LARGE_INTEGER que identifica a rotina de retorno de chamada para cancelar o registro. cmRegisterCallback forneceu esse valor quando você registrou a rotina de retorno de chamada.
Valor de retorno
CmUnRegisterCallback retornará STATUS_SUCCESS se tiver êxito ou se o código de erro NTSTATUS apropriado se falhar. Se o parâmetro Cookie não corresponder a nenhuma rotina de retorno de chamada registrada, CmUnRegisterCallback retornará STATUS_INVALID_PARAMETER.
Observações
Um driver que chama cmRegisterCallback ou CmRegisterCallbackEx deve chamar CmUnRegisterCallback antes que o driver seja descarregado.
Um driver não deve chamar CmUnRegisterCallback de sua implementação da rotina de RegistryCallback. Essa chamada resultará em um deadlock.
Para obter mais informações sobre cmUnRegisterCallback e filtragem de operações de registro, consulte Filtrando chamadas de registro.
Requisitos
Requisito | Valor |
---|---|
da Plataforma de Destino | Universal |
cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
biblioteca | NtosKrnl.lib |
de DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm) |