Share via


Método Installer.RegistryValue

O método RegistryValue do objeto Installer lê as informações sobre uma chave de valor do Registro especificada. Se a chave ou o valor especificado não existir, o método retornará o erro 9, "Subscrito fora do intervalo".

Sintaxe

Installer.RegistryValue(
  root,
  key,
  value
)

Parâmetros

root

No Windows NT 4.0, a raiz do Registro é uma chave raiz numérica ou um nome de computador como uma cadeia de caracteres. Os nomes de computadores são sempre cadeias de caracteres. No Windows 95, no Windows 98 ou no Windows Me, a raiz do Registro é apenas uma chave raiz numérica. Você só pode acessar o HKLM em um computador remoto.

Root Significado
HKEY_CLASSES_ROOT
0
HKEY_CURRENT_USER
1
HKEY_LOCAL_MACHINE
2
HKEY_USERS
3
HKEY_PERFORMANCE_DATA
4
HKEY_CURRENT_CONFIG
5
HKEY_DYN_DATA
6

 

chave

Uma cadeia de caracteres que contém o caminho de chave completo da raiz.

value

Esse parâmetro opcional designa o valor associado que será retornado para a chave especificada. O valor é um dos valores mostrados na tabela a seguir.

Valor Significado
Ausente ou em branco
Retorna um booliano designando se a chave existe.
Cadeia de caracteres
Retorna os dados associados ao valor nomeado e falhará se o nome do valor não existir.
Inteiro positivo
Retorna o nome do valor enumerado baseado em 1, se inexistente, ele fica vazio. Essa opção usa a função RegEnumValue.
Inteiro negativo
Retorna o nome da subchave enumerada baseada em 1. Esse campo ficará vazio, se não existir. Essa opção usa a função RegEnumKey.
Inteiro zero
Retorna o nome da classe de cadeia de caracteres para a chave designada.
Cadeia de caracteres vazia " "
Retorna o valor padrão da chave do Registro.

 

Valor retornado

Esse método não retorna um valor.

Requisitos

Requisito Valor
Versão
Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL
Msi.dll
IID
O IID_IInstaller é definido como 000C1090-0000-0000-C000-000000000046