Tabela RegLocator
A tabela RegLocator contém as informações necessárias para pesquisar um arquivo ou diretório usando o registro ou pesquisar uma entrada de registro em si. Esta tabela tem as seguintes colunas.
Coluna | Tipo | Chave | Nullable |
---|---|---|---|
Assinatura_ | identificador de | Y | N |
Raiz | inteiro | N | N |
Chave | RegPath | N | N |
Nome | 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 Type 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 do
-
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 do
-
O nome do valor do Registro. Se esse valor for nulo, o valor do valor não nomeado ou padrão da chave, se houver, será recuperado.
-
Tipo de
-
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, o tipo será 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 esse bit para que o instalador pesquise a parte de 64 bits do Registro. Não defina esse bit para que o instalador pesquise a parte de 32 bits do Registro.
Observações
Observe que, se o valor no campo Tipo for msidbLocatorTypeRawValue, o instalador definirá o valor da propriedade especificada no campo Propriedade 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 registro | Prefixo adicionado pelo Instalador |
---|---|
REG_SZ | Nenhum, mas se o primeiro caractere do valor do Registro for #, o instalador escapará do caractere prefixando outro #. |
DWORD | "#" opcionalmente seguido por '+' ou '-' |
REG_EXPAND_SZ | "#%" |
REG_MULTI_SZ | Zero. O instalador define a propriedade como um valor começando com um nulo e terminando com um nulo. |
REG_BINARY | "#x" No 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 são localizadas. Se um autor decidir pesquisar produtos em vários idiomas, deverá 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 pesquisar o valor padrão de uma chave e recuperar seu valor se ela não estiver vazia.
Para obter mais informações, consulte Pesquisa de Aplicativos, Arquivos, Entradas do Registro ou Entradas de Arquivo .ini.
Validação