estrutura REG_SET_VALUE_KEY_INFORMATION (wdm.h)

  • Artigo

A estrutura REG_SET_VALUE_KEY_INFORMATION descreve uma nova configuração para a entrada de valor de uma chave do Registro.

Sintaxe

typedef struct _REG_SET_VALUE_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING ValueName;
  ULONG           TitleIndex;
  ULONG           Type;
  PVOID           Data;
  ULONG           DataSize;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_SET_VALUE_KEY_INFORMATION, *PREG_SET_VALUE_KEY_INFORMATION;

Membros

Object

Um ponteiro para o objeto de chave do Registro para a chave cuja entrada de valor está prestes a ser alterada.

ValueName

Um ponteiro para uma estrutura UNICODE_STRING que contém o nome da entrada de valor prestes a ser alterada.

TitleIndex

Reservado para uso do sistema. Os drivers devem ignorar esse membro.

Type

O tipo de dados que está prestes a ser gravado. Para obter mais informações sobre os valores possíveis para esse membro, consulte o parâmetro Type de ZwSetValueKey.

Data

Um ponteiro para um buffer que contém os dados prestes a serem gravados. O formato do buffer depende do valor de Tipo. Para obter mais informações, consulte ZwSetValueKey.

DataSize

O tamanho, em bytes, do buffer de dados .

CallContext

Informações de contexto opcionais definidas pelo driver que a rotina RegistryCallback do driver pode fornecer. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.

ObjectContext

Um ponteiro para informações de contexto definidas pelo driver que o driver associou a um objeto do Registro chamando CmSetCallbackObjectContext. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.

Reserved

Este membro é reservado para uso futuro. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.

Comentários

O sistema passa essa estrutura para uma rotina RegistryCallback sempre que um thread tenta definir uma entrada de valor para uma chave, por exemplo, quando um thread no modo de usuário chama RegSetValue ou RegSetValueEx ou quando um driver chama ZwSetValueKey.

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 no Microsoft Windows XP e versões posteriores do sistema operacional Windows.
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Confira também

CmSetCallbackObjectContext

RegistryCallback

ZwSetValueKey