estrutura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)
A estrutura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION contém informações que a rotina RegistryCallback de um driver pode usar para liberar recursos que o driver alocou anteriormente para o contexto associado a um objeto do Registro.
Sintaxe
typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
PVOID Object;
PVOID ObjectContext;
PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;
Membros
Object
Um ponteiro para o objeto de chave do Registro para que a chave seja excluída.
ObjectContext
Um ponteiro para informações de contexto definidas pelo driver que o driver associou a um objeto do Registro chamando CmSetCallbackObjectContext.
Reserved
Esse membro é reservado para uso futuro.
Observações
Essa estrutura é usada pela rotina de RegistryCallback. Quando o parâmetro Argument1 para a rotina de RegistryCallback é RegNtCallbackObjectContextCleanup, o parâmetro Argument2 é um ponteiro para uma estrutura de REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION.
A rotina RegistryCallback do driver receberá uma notificação RegNtCallbackObjectContextCleanup quando a contagem de referência do objeto chave cair para zero (ou seja, não há identificadores pendentes ou referências de ponteiro para o objeto de chave).
Em resposta a essa notificação, a rotina deve liberar todos os recursos alocados para o contexto do objeto. A notificação RegNtCallbackObjectContextCleanup ocorre quando o driver chamou CmUnRegisterCallback ou a rotina de registryCallback do do driver acabou de concluir o processamento de uma notificação de regNtPreKeyHandleClose.
Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas de registro.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows Vista. |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |