estrutura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)

  • Artigo

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

Este membro é reservado para uso futuro.

Comentários

Essa estrutura é usada pela rotina RegistryCallback . Quando o parâmetro Argument1 para a rotina RegistryCallback é RegNtCallbackObjectContextCleanup, o parâmetro Argument2 é um ponteiro para uma estrutura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION .

A rotina RegistryCallback do driver receberá uma notificação RegNtCallbackObjectContextCleanup quando a contagem de referência do objeto de 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 chama CmUnRegisterCallback ou a rotina RegistryCallback do driver acaba de processar uma notificação RegNtPreKeyHandleClose .

Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas do Registro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows Vista.
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Confira também

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback