INFO: Interface Windows Rundll e Rundll32

Rundll vs. Rundll32

Voltar para o início

Linha de comando Rundll

   RUNDLL.EXE <dllname>,<entrypoint> <optional arguments>
				

   RUNDLL.EXE SETUPX.DLL,InstallHinfSection 132 C:\WINDOWS\INF\SHELL.INF
				

1. O Rundll ou o Rundll32 procura o nome da DLL dada nos locais padrão (para ver maiores detalhes da função LoadLibrary(), consulte a documentação pertinente) Recomenda-se que seja forneçido o caminho completo para a DLL, para ter certificar-se de que encontre a DLL correta. Para melhores resultados, use o nome de arquivo curto em vez do nome de arquivo longo, para ter certeza de que nenhum caractere inválido aparecerá. Note que isso, em especial, significa que a DLL na pasta"C:\Arquivos de Programas" deve ser convertido para um nome menor.
2. O nome da DLL <dllname> não pode conter nenhum espaço, vírgulas ou aspas. Isso é uma limitação no analisador de linha de comando do Rundll.
3. Na linha de comando acima, a vírgula (,) entre o<dllname> e a função <entrypont> é extremamente importante. Se a virgula estiver faltando, o Rundll ou o Rundll32 irá falhar sem que haja a indicação de erro. Além disso, não pode existir nenhum espaço entre o <dllname>, a vírgula e a função <entrypoint>.

Voltar para o início

Como funciona o Rundll

1. Ele analisa a linha de comando.
2. Ele carrega a DLL específica pela LoadLibrary ().
3. Ele obtém o endereço da função <entrypoint> via GetProcAddress().
4. Ele chama a função <entrypoint>, passando a extensão da linha de comando que são os <optional arguments>.
5. Quando a função <entrypoint> retorna, o Rundll.exe descarrega a DLL e fecha.

Voltar para o início

Como escrever sua DLL

  void FAR PASCAL __loadds
  EntryPoint(HWND hwnd, HINSTANCE hinst, LPSTR lpszCmdLine, int nCmdShow);
				

  void CALLBACK
  EntryPoint(HWND hwnd, HINSTANCE hinst, LPSTR lpszCmdLine, int nCmdShow);
				

1. É claro que o nome "EntryPoint" deve ser substituído com o nome real de sua função de ponto de entrada. Note que o ponto de entrada do Rundll32 não possui nenhuma relação com a função DllEntryPoint em uma DLL de 32 bits que controla processos e thread anexar/retirar notificações.
2. A função de ponto de entrada para Rundll32 precisa ser definida usando a convenção de chamada _stdcall (padrões CALLBACK de uso do atributo _stdcall) Se o atributo _stdcall estiver faltando, os padrões de função para convenção de chamada _cdecl e o Rundll32 serão terminados anormalmanete após chamar a função.
3. Uma vez que você deve declarar a função com a convenção de chamada _stdcall, da maneira descrita acima, o resultado será que o compilador Visual C++ irá exportá-la como _EntryPoint@16 se a DLL estiver escrita em C ou simplificará o nome se a DLL estiver escrita em C++. Por isso, esteja atento para usar o nome de exportação correto na linha de comando para Rundll ou Rundll32. Se você deseja evitar o uso de nomes simplificados, use um arquivo .def e exporte a função do ponto de entrada pelo nome. Consulte a documentação do produto e o seguinte artigo para obter informações adicionais sobre simplificação de nome quando estiver usando compiladores Visual C++:
   140485  (http://support.microsoft.com/kb/140485/PT-BR/ ) Exporting PASCAL-Like Symbols in 32-bit DLLs

   hwnd - identificador de janela que deveria ser usado como a janela owner para 
           quaisquer janelas que a sua DLL criar
   hinst - seu identificador de ocorrências da DLL
   lpszCmdLine - Linha de comando ASCIIZ que sua DLL deve analisar
   nCmdShow - descreve como suas janelas da DLL devem ser exibidas
				

     RUNDLL.EXE SETUPX.DLL,InstallHinfSection 132 C:\WINDOWS\INF\SHELL.INF
				

   hwnd = (identificador de janela pai)
   hinst = HINSTANCE do SETUPX.DLL
   lpszCmdLine = "132 C:\WINDOWS\INF\SHELL.INF"
   nCmdShow = (Qualquer coisa que o nCmdShow tenha passado para CreateProcess)
				

Voltar para o início

Observações especiais com relação a diferença entre o Windows 95 e Windows NT

   void CALLBACK
   EntryPointW(HWND hwnd, HINSTANCE hinst, LPWSTR lpszCmdLine,
               int nCmdShow);
				

Voltar para o início