Tabela RegLocator
A tabela RegLocator contém as informações necessárias para pesquisar um arquivo ou um diretório usando o registro, ou pesquisar a própria entrada de registro específica. Essa tabela tem as seguintes colunas.
| Coluna | Tipo | Chave | Nullable |
|---|---|---|---|
| Signature_ | Identificador | S | N |
| Root | Inteiro | N | N |
| Chave | RegPath | N | N |
| Nome | Formatted | N | Y |
| Tipo | Inteiro | N | S |
Colunas
-
Signature_
-
O valor no campo Signature_ representa uma assinatura exclusiva que é uma chave externa na coluna um da tabela Signature. 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 de registro apontado pela tabela RegLocator. Caso contrário, a pesquisa será para um diretório apontado pela tabela RegLocator.
-
Raiz
-
A chave-raiz predefinida para o valor de 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 do valor de registro.
-
Nome
-
O nome do valor de registro. Se esse valor for nulo, o valor não nomeado ou padrão da chave será recuperado, se houver .
-
Tipo
-
Um valor que determina se o valor de registro é um nome de arquivo, um local de diretório ou um valor bruto do registro.
A tabela a seguir lista os valores válidos. Defina um dos três primeiros valores e msidbLocatorType64bit, se necessário. Se a entrada nesse campo estiver ausente, Tipo será definido para 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 de 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.
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 de registro. O instalador adiciona um prefixo ao valor de registro que identifica o tipo do valor de registro. Para obter mais informações sobre os tipos dos valores de registro, confira Tipos dos valores de registro.
| Tipo de Registro | Prefixo adicionado pelo instalador |
|---|---|
| REG_SZ | Nenhum, mas se o primeiro caractere do valor de registro for #, o instalador aplicará o escape no caractere prefixando outro #. |
| DWORD | "#" opcionalmente seguido por '+' ou '-' |
| REG_EXPAND_SZ | "#%" |
| REG_MULTI_SZ | Nulo. O instalador define a propriedade para um valor que começa e termina com um nulo. |
| REG_BINARY | "#x" No caso de REG_BINARY, o instalador converte e salva cada dígito hexadecimal (parte) como um caractere ASCII prefixado com "#x". |
Normalmente, as colunas nessa 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, confira Pesquisando aplicativos, arquivos, entradas de registro ou entradas do arquivo .ini existentes.
Validação