Definindo níveis de log da API SetupAPI

Pode controlar a quantidade de informação escrita no registo SetupAPI, seja para todas as aplicações de instalação de dispositivos ou para aplicações individuais de instalação de dispositivos.

Para alterar o nível de informação escrito no registo SetupAPI para todas as aplicações de instalação de dispositivos, crie (ou modifique) o seguinte valor de registo:

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel

Ao definir este valor (usando os valores listados nas tabelas abaixo) pode escolher o nível de erros registados, modificar a verbosidade do registo ou desativar o registo. Também pode registar informações num depurador, bem como no ficheiro de registo.

Para especificar níveis de registo em log para aplicações individuais de instalação de dispositivos, crie uma entrada de registo sob a seguinte chave:

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\AppLogLevels

Sob esta chave, crie um nome de valor que represente o nome do ficheiro executável da aplicação e atribua o nível de registo desejado a esse nome (usando os valores listados nas tabelas abaixo), como service.exe=LoggingLevel.

O nível de registo é um valor DWORD. Se este valor não for especificado ou for zero, a SetupAPI utiliza um comportamento padrão, conforme indicado nas tabelas abaixo.

O valor DWORD é composto por três partes, formatadas como 0xSSSSDDGG. Os oito bits baixos, representados pelo 0x000000FF da máscara, definem o nível de registo para operações gerais de instalação do dispositivo. Os oito bits seguintes, representados pela máscara 0x0000FF00, definem o nível de registo para as operações de instalação do dispositivo. Os bits mais altos são flags especiais.

As tabelas seguintes contêm os níveis gerais de registo, níveis de registo de instalação de dispositivos e flags especiais de registo para Windows 2000 e versões posteriores.

Por exemplo, o SetupAPI interpreta alguns valores de exemplo de LoggingFlags da seguinte forma:

• 0x00000000 significa logging predefinido.

• 0x0000FFFF significa registo detalhado.

• 0x8000FF00 significa registar informações detalhadas de instalação de dispositivos tanto no ficheiro de registo como no depurador.

Para modificar os níveis de registo em ficheiro predefinidos da SetupAPI durante uma instalação limpa, edite o registo do Windows durante o período entre a configuração em modo texto e a configuração em modo GUI. Os passos seguintes descrevem o procedimento. Estes passos assumem que estás a instalar para D:\Winnt e tens uma compilação funcional da mesma versão do Windows noutra partição. Altere os níveis de registo da SetupAPI da seguinte forma:

1. Começa a instalação da build limpa que estás a testar.

2. Pare o processo de configuração durante o primeiro arranque após a configuração em modo texto (ou seja, antes da configuração em modo GUI).

3. Inicia a compilação funcional selecionando-a no menu de arranque e inicia sessão como Administrador.

4. Encontre os ramos do registo (ficheiros) em D:\Winnt\System32\config. Neste caso, precisa de modificar o ramo do registo em Software.sav.

5. No Windows 2000, execute o Regedt32, selecione a janela "HKEY_LOCAL_MACHINE na Máquina Local" e selecione a chave HKEY_LOCAL_MACHINE. Depois clica no menu Registro e seleciona Carregar ramificação.

   No Windows XP e versões posteriores, execute o RegEdit. Destaca HKEY_LOCAL_MACHINE, clica no menu Ficheiro e seleciona Carregar ramo.

6. Navegue pelos ficheiros e selecione D:\Winnt\System32\config\software.sav. Quando for solicitado o nome da chave, introduza "_sw.sav "

7. Abra a tecla _sw.sav em HKEY_LOCAL_MACHINE e destaque a seguinte tecla:

   HKEY_LOCAL_MACHINE_sw.sav\Microsoft\Windows\CurrentVersion\Setup
   

   No Windows 2000, clique no menu Segurança, selecione Permissões e conceda controlo total ao Administrador.

   No Windows XP e versões posteriores, clique no menu Editar, selecione Permissões e conceda controlo total ao Administrador.

8. No Windows 2000, adicione os valores necessários do registo sob esta chave clicando em Editar e selecionando Adicionar Valor.

   No Windows XP e versões posteriores, clique em Edit e selecione Novo Valor DWORD.

   Introduza o valor. Por exemplo, adicione "0xFFFF" para permitir o registo detalhado completo.

9. Selecione HKEY_LOCAL_MACHINE\_sw.sav, e descarregue a colmeia (usando o menu Registo no Windows 2000, ou o menu Ficheiro no Windows XP e posteriores). A chave _sw.sav deverá desaparecer.

10. Copiar D:\Winnt\System32\config\software.sav para D:\Winnt\System32\config\software.

11. Reinicia e continua para o Setup.

12. Para verificar esta alteração, pressione SHIFT+F10 no modo GUI-mode Setup, depois execute regedit.exe e verifique o nível de logging.