INFO: Interfaces Rundll e Rundll32 do Windows

Rundll vs. Rundll32

Voltar ao topo

Linha de comandos de Rundll

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

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

1. Rundll ou Rundll32 procuram o nome de ficheiro da DLL indicado nas localizações padrão (consulte a documentação relativa à função LoadLibrary() para obter detalhes). Recomenda-se que forneça um caminho completo para a DLL de modo a garantir que é localizada a DLL correcta. Para obter os melhores resultados, utilize o nome de ficheiro abreviado em vez do nome de ficheiro longo para garantir que não são apresentados caracteres ilegais. Repare que isto significa que uma DLL na pasta "C:\Programas" ("C:\Program Files") deverá ser convertida para o respectivo nome abreviado.
2. O <nome_da_dll> não poderá conter quaisquer espaços, vírgulas ou aspas. Esta é uma limitação do analisador da linha de comandos de Rundll.
3. Na linha de comandos mencionada acima, a vírgula (,) entre o <nome_da_dll> e o nome da função <ponto_de_entrada> é extremamente importante. Se a vírgula separadora não existir, a execução de Rundll ou Rundll32 falhará sem que sejam apresentadas quaisquer mensagens de erro. Além disso, não poderão existir espaços em branco entre o <nome_da_dll>, a vírgula e a função <ponto_de_entrada>.

Voltar ao topo

Como funciona Rundll

1. Analisa a linha de comandos.
2. Carrega a DLL especificada através de LoadLibrary().
3. Obtém o endereço da função <ponto_de_entrada> através de GetProcAddress().
4. Chama a função <ponto_de_entrada>, passando o fim da linha de comandos, que são os <argumentos opcionais>.
5. Quando a função <ponto_de_entrada> termina, Rundll.exe descarrega a DLL e termina.

Voltar ao topo

Como escrever a 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. Obviamente, o nome "Ponto_De_Entrada" deverá ser substituído pelo nome real da sua função de ponto de entrada. Note que o ponto de entrada de Rundll32 não está relacionado com a função DllEntryPoint de uma DLL de 32 bits, que trata notificações de acções ligar/desligar de processos e threads.
2. A função do ponto de entrada de Rundll32 tem de ser definida com a convenção de chamada _stdcall (CALLBACK utilizará o atributo _stdcall). Se o atributo _stdcall estiver em falta, a função utilizará a convenção de chamada _cdecl predefinida e, em seguida, Rundll32 terminará incorrectamente após a chamada da função.
3. Uma vez que é necessário declarar a função com a convenção de chamada _stdcall do modo descrito anteriormente, o compilador de Visual C++ exportá-la-á como _EntryPoint@16 se a DLL estiver escrita em C ou utilizará outra decoração de nomes se a DLL estiver escrita em C++. Assim, certifique-se de que utiliza correctamente o nome exportado na linha de comandos de Rundll ou Rundll32. Se pretende evitar a utilização de nomes decorados, utilize um ficheiro .def e exporte a função do ponto de entrada pelo nome. Consulte a documentação do produto e o artigo que se segue para obter mais informações sobre decoração de nomes ao utilizar compiladores de Visual C++:
   140485  (http://support.microsoft.com/kb/140485/PT/ ) Exporting PASCAL-Like Symbols in 32-bit DLLs

   hwnd - identificador de janela que deverá ser utilizado como a janela proprietária para
          quaisquer janelas criadas pela DLL
   hinst - o identificador da instância da sua DLL
   lpszCmdLine - linha de comandos ASCIIZ que deverá ser analisada pela DLL
   nCmdShow - descreve o modo de apresentação das janelas da DLL
				

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

   hwnd = (identificador da janela principal)
   hinst = HINSTANCE de SETUPX.DLL
   lpszCmdLine = "132 C:\WINDOWS\INF\SHELL.INF"
   nCmdShow = (independentemente do nCmdShow passado a CreateProcess)
				

Voltar ao topo

Notas especiais sobre diferenças entre o Windows 95 e o Windows NT

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

Voltar ao topo