Explicação do uso do Regsvr32 e mensagens de erro

Você pode utilizar a ferramenta Regsvr32 (Regsvr32.exe) para registrar e cancelar o registro de controles OLE (Vinculação e Incorporação do Objeto), como DLLs ou arquivos de Controles ActiveX (OCX) que se registram automaticamente. Isso pode ser útil para solucionar problemas no Windows, no Microsoft Internet Explorer, entre outros programas. Por exemplo, o artigo correspondente na Base de Dados de Conhecimento Microsoft necessita da utilização da ferramenta Regsvr32.exe para cancelar o registro do controle Wuv3is.dll antes da reinstalação pelo site do Windows Update: Se o registro de um controle não tiver êxito ou precisar de informações de um desenvolvedor sobre como resolver problemas relacionados às tentativas sem êxito do registro de controles OLE, consulte o artigo correspondente na Base de Dados de Conhecimento Microsoft:

A ferramenta Regsvr32.exe está incluída no Microsoft Internet Explorer 3.0, Windows 95 OEM Service Release 2 (OSR2) e no Windows NT 4.0 Service Pack 5 (SP5) ou versões mais recentes. A ferramenta Regsvr32.exe está instalada na pasta System (Windows Me/Windows 98/Windows 95) ou System32 (Windows NT/Windows XP/Windows Vista/Windows 7).

Observação Em uma versão do sistema operacional do Windows de 64 bits, existem duas versões do arquivo Regsv32.exe:

• A versão de 64 bits é %systemroot%\System32\regsvr32.exe.
• A versão de 32 bits é %systemroot%\SysWoW64\regsvr32.exe.

Uso do Regsvr32.exe

A ferramenta RegSvr32.exe tem as seguintes opções da linha de comando: Ao utilizar a ferramenta Regsvr32.exe, ela tenta carregar o componente e chamar sua função DLLSelfRegister. Se a tentativa tiver êxito, a ferramenta Regsvr32.exe apresenta uma caixa de diálogo com essa indicação. Caso contrário, a ferramenta Regsvr32.exe devolve uma mensagem de erro. Poderá incluir um código de erro Win32. Para obter mais informações, clique no número abaixo para ler o artigo na Base de Dados de Conhecimento Microsoft (a página pode estar em inglês): Por exemplo, para registrar manualmente um controle ActiveX Sample.ocx, digite o seguinte comando no prompt de comando:

Mensagens de erro Regsvr32.exe no Windows Vista e mais recente

A seguinte lista contém mensagens de erro RegSvr32 e possíveis causas.

O sinalizador de comando ""%1"" não é válido. Revise a utilização do comando e tente novamente.

Uma combinação inválida de opções foi transmitida na linha de comandos para o regsvr32.exe.

Este comando é válido apenas se um projeto de Controle Personalizado OLE do Microsoft Visual Studio estiver aberto.

A ferramenta Regsvr32.exe foi invocada pelo Visual Studio, mas não foram especificados módulos na linha de comando.

Paras registrar um módulo, você deve fornecer um nome binário.

A ferramenta Regsvr32.exe foi invocada sem especificar quaisquer módulos na linha de comando.

Falha ao executar o comando OleInitialize. O computador poderá estar com falta de memória. Feche os programas que estiverem abertos e tente novamente.

É necessário que a ferramenta Regsvr32 inicialize a biblioteca COM antes de chamar as funções da biblioteca COM e não inicializar a biblioteca quando ela for desligada. Essas mensagens de erro são exibidas se uma tentativa de inicializar ou não inicializar a biblioteca COM for mal-sucedida.

Falha ao carregar o módulo ""%1"".\n\n Certifique-se de que o binário é armazenado no caminho especificado ou depure-o para verificar se há problemas com o binário ou arquivos .DLL dependentes.\n\n%2.

Ocorreu um erro ao carregar um módulo que foi especificado na linha de comando. O texto do erro é apresentado como parte da mensagem.

O módulo ""%1"" foi carregado, mas o ponto de entrada %2 não foi encontrado.\n\nCertifique-se de que ""%1"" é um DLL válido ou arquivo OCX e tente novamente

A ferramenta Regsvr32.exe não conseguiu localizar o ponto de entrada necessário no módulo especificado na linha de comando. Isto pode acontecer caso os pontos de entrada não sejam exportados do módulo corretamente ou se o módulo não for um arquivo .DLL ou .OCX.

O módulo ""%1"" foi carregado, mas a chamada para %2 falhou com o código de erro %3.\n\n Para obter mais informação sobre este problema, pesquise online usando o código de erro como um termo de pesquisa.

Ocorreu um erro quando a ferramenta Regsvr32.exe invocou o ponto de entrada no módulo especificado na linha de comando. O código de erro é apresentado como parte da mensagem

O módulo ""%1"" pode não ser compatível com a versão do Windows em execução. Verifique se o módulo é compatível com uma versão de x86 (32 bits) ou de x64 (64 bits) da ferramenta regsvr32.exe.

Este erro pode ocorrer, por exemplo, se a ferramenta regsvr32.exe for executada em um computador de x86 e o módulo especificado na linha de comando é um módulo de 64 bits.

Mensagens de erro Regsvr32.exe anteriores ao Windows Vista

A seguinte lista contém mensagens de erro RegSvr32 e possíveis causas.

Sinalizador não reconhecido: /sinalizador_inválido

Você digitou uma combinação inválida de sinalizadores ou opções (consulte a seção "Uso da ferramenta Regsvr32.exe" neste artigo).

Nenhum nome de DLL especificado.

Você não incluiu um nome de arquivo .dll (consulte a seção "Uso da ferramenta Regsvr32.exe" neste artigo).

nomeDll foi carregado, mas o ponto de entrada DllRegisterServer ou DllUnregisterServer não foi encontrado.

nomeDll não é um arquivo .dll ou .ocx. Por exemplo, ao digitar regsvr32 wjview.exe uma mensagem de erro será gerada.

nomeDll não é um arquivo executável e não existe auxiliar de registro registrado para esse tipo de arquivo.

nomeDll não é um arquivo executável (.exe, .dll ou .ocx). Por exemplo, ao digitar regsvr32 autoexec.bat uma mensagem de erro será gerada.

nomeDll foi carregado, mas o ponto de entrada DllRegisterServer ou DllUnregisterServer não foi encontrado.

nomeDll talvez não possa ser exportado ou uma versão corrompida de nomeDll talvez esteja na memória. Considere usar Pview para detectar o arquivo e remova-o.

nomeDll não tem registro automático ou uma versão corrompida talvez esteja na memória.

Por exemplo, ao digitar regsvr32 icwdial.dll uma mensagem de erro será exibida porque o arquivo Icwdial.dll não tem registro automático. Se você suspeita que uma versão corrompida do Dllname está na memória, tente reiniciar o computador ou extrair novamente a versão original do arquivo. Se estiver executar o Windows NT, talvez seja necessário usar a ferramenta Kill ou a ferramenta Pview do Kit de recursos do Microsoft Windows NT Server 4.0. Para obter mais informações, clique no seguinte número para ler o artigo na Base de Dados de Conhecimento Microsoft (a página pode estar em inglês): OleInitialize falhou (ou OleUninitialize falhou).

É necessário que a ferramenta Regsvr32 inicialize a biblioteca COM antes de chamar as funções da biblioteca COM e não inicializar a biblioteca quando ela for desligada. Essas mensagens de erro são exibidas se uma tentativa de inicializar ou não inicializar a biblioteca COM for mal-sucedida. Por exemplo, o arquivo Ole32.dll talvez esteja corrompido ou talvez seja a versão incorreta.

LoadLibrary("Dllname") falhou. GetlastError retorna 0x00000485

From Winerror.h, 0x00000485 = 1157 (ERROR_DLL_NOT_FOUND), que significa "Um dos arquivos da biblioteca necessários para executar este aplicativo não pôde ser encontrado". Por exemplo, ao digitar regsvr32 missing.dll uma mensagem de erro será exibida porque não foi possível encontrar o arquivo Missing.dll.

LoadLibrary("Dllname") falhou. GetlastError retorna 0x00000002

From Winerror.h, 0x00000002 = 2 (ERROR_FILE_NOT_FOUND), que significa "O arquivo não foi encontrado". Em outras palavras, um arquivo .dll dependente não foi encontrado. Por exemplo, ao digitar regsvr32 icwdial.dll com o arquivo Tapi32.dll (uma dependência) ausente, essa mensagem de erro será exibida.

LoadLibrary("dskmaint.dll") falhou. GetlastError retorna 0x000001f

From Winerror.h, 0x000001f = 31 (ERROR_GEN_FAILURE), que significa "Um dispositivo conectado ao sistema não está funcionando". É possível que esse comportamento ocorra se tentar registrar um arquivo Win16 .dll. Por exemplo, ao digitar regsvr32 dskmaint.dll uma mensagem de erro será gerada.

DllRegisterServer (ou DllUnregisterServer) no Dllname falhou. O código de retorno era: string

Pesquisar Winerror.h para cadeia de caracteres.