Partilhar via


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)

Consulte também

CmRegisterCallback

CmRegisterCallbackEx

RegistryCallback