Partilhar via


Tabela RegLocator

A tabela RegLocator contém as informações necessárias para procurar um ficheiro ou diretório utilizando o registo ou para procurar uma entrada de registo específica. Esta tabela tem as seguintes colunas.

Coluna Tipo Chave Nulo
Signature_ Identificador Y N
Raiz inteiro N N
Chave RegPath N N
Designação Formatado N Y
Tipo inteiro N Y

 

Colunas

Signature_

O valor no campo Signature_ representa uma assinatura exclusiva que é uma chave externa na coluna um da tabela Assinatura. Se essa assinatura estiver presente na tabela Assinatura, a pesquisa será por um arquivo. Se essa assinatura estiver ausente da tabela Assinatura e o valor da coluna Tipo for msidbLocatorTypeRawValue, a pesquisa será pelo nome da chave do Registro apontado pela tabela RegLocator. Caso contrário, a pesquisa é para um diretório apontado pela tabela RegLocator.

Raiz

A chave raiz predefinida para o valor do Registro.

Constante Hexadecimal Decimal Chave raiz
msidbRegistryRootClassesRoot 0x000 0 HKEY_CLASSES_ROOT
msidbRegistryRootCurrentUser 0x001 1 HKEY_CURRENT_USER
msidbRegistryRootLocalMachine 0x002 2 HKEY_LOCAL_MACHINE
msidbRegistryRootUsers 0x003 3 HKEY_USERS

 

Chave

A chave para o valor do Registro.

Nome

O nome do valor do Registro. Se esse valor for nulo, o valor do valor sem nome ou padrão da chave, se houver, será recuperado.

Tipo

Um valor que determina se o valor do Registro é um nome de arquivo, um local de diretório ou um valor bruto do Registro.

A tabela a seguir lista valores válidos. Defina um dos três primeiros valores e msidbLocatorType64bit se necessário. Se a entrada neste campo estiver ausente, Type é definido como 1.

Constante Hexadecimal Decimal Descrição
msidbLocatorTypeDirectory 0x000 0 O caminho da chave é um diretório.
msidbLocatorTypeFileName 0x001 1 O caminho da chave é um nome de arquivo.
msidbLocatorTypeRawValue 0x002 2 O caminho da chave é um valor do Registro.
msidbLocatorType64bit 0x010 16 Defina este bit para que o instalador pesquise a parte de 64 bits do registo. Não defina este bit para que o instalador pesquise a parte de 32 bits do registo.

 

Comentários

Observe que, se o valor no campo Type for msidbLocatorTypeRawValue, o instalador definirá o valor da propriedade especificada no campo Property da tabela AppSearch para o valor do Registro. O instalador adiciona um prefixo ao valor do Registro que identifica o tipo de valor do Registro. Para obter mais informações sobre tipos de valores do Registro, consulte Tipos de valor do Registro.

Tipo de registo Prefixo adicionado pelo instalador
REG_SZ Nenhum, mas se o primeiro caractere do valor do Registro for #, o instalador escapará do caractere prefixando um outro #.
DWORD "#" opcionalmente seguido de '+' ou '-'
REG_EXPAND_SZ "#%"
REG_MULTI_SZ Nulo. O instalador define a propriedade como um valor que começa com um null e termina com um null.
REG_BINARY "#x" Em caso de REG_BINARY, o instalador converte e salva cada dígito hexadecimal (nibble) como um caractere ASCII prefixado por "#x".

 

Normalmente, as colunas nesta tabela não estão localizadas. Se um autor decidir pesquisar produtos em vários idiomas, então deve haver uma entrada separada incluída na tabela para cada idioma.

Observe que não é possível usar a tabela RegLocator para verificar apenas a presença da chave. No entanto, você pode procurar o valor padrão de uma chave e recuperar seu valor se ela não estiver vazia.

Para obter mais informações, consulte Procurando aplicativos existentes, arquivos, entradas do Registro ou entradas de arquivo .ini.

Validação

ICE03
ICE06
ICE46
ICE80