Utiliser DLLImport

[davydavek]

Ce tutoriel n'est pas destiné au débutants, mais plutôt a ceux qui ont déjà de l’expérience en C# ou VB.NET

 

DLL ... what ?

 

Les DLLs (Dynamic-Link Library) sont des fichiers non-exécutables, qui contiennent des fonctions pouvant être utilisée par d'autres applications.

 

Windows fonctionne justement avec des DLLs (%windir%\system32\ pour ceux qui voudrait les voir).

 

Les principales sont : 

-user32.dll (User inferface (MessageBox, Bouttons, etc ...))

-kernel32.dll (Fichiers, Mémoire, Processus/threads etc...)

-gdi32.dll (Graphiques) 

 

Ces DLL forment ce qu'on appelle l'API* Windows, ou l'API* Win32.

 

*API : Application Programming Interface

NB: Il y a aussi ntdll.dll, qui contient l'API Native de Windows.

 

Dans ce tutoriel je vais donc vous apprendre a importer les fonctions FindWindow et FlashWindow, exportées par user32.dll .

 

 

 

DLLImport

 

Pour importer ces fonctions, on va utiliser DLLImport, il requiert la classe DLLImportAttribute, dans le namespace System.Runtime.InteropServices :

 

using System.Runtime.InteropServices;

 

Description des paramètres :

-string dllName : Le chemin vers la DLL, et son nom. (On va utiliser une DLL de windows donc on n'a pas besoin de spécifier le chemin)

 

-bool BestFitMappig (par défaut true) : Permet de convertir les caractères UNICODE en ANSI, si il est true alors la conversion utilise le caractère ANSI le plus proche (best fit).

 

-CallingConvention CallingConvention (par défaut CallingConvention.StdCall/Winapi) : Un membre de l'enum CallingConvention, c'est assez low-level, donc je ne vais pas l'expliquer ici, vous pouvez lire la doc si vous en avez envie.

 

-CharSet CharSet (par défaut CharSet.Ansi) : En fait certaines fonctions ont deux types. Par exemple MessageBoxA, et MessageBoxW. Pour importer MessageBoxA il faut utiliser Charset.Ansi, et pour MessageBoxW, Charset.Unicode. , L'Ansi, sauvegarde chaque caractère dans un byte, ce qui fait qu'il n'y a que 256 caractère disponibles (dictionnaires "basique" : francais/anglais ...), Charset.Unicode utilise deux bytes (DBCS), ce qui permet d’accéder a 65,536 (256²) caractères. (arabe/chinois/coréen etc..)

 

-string EntryPoint : Le nom de la fonction que vous voulez importer.

 

-bool ExactSpelling (par défaut false en C# mais true en VB) : Si true, vous devez nommer la fonction avec son nom exact (en incluant le A/W, si nécessaire).

 

-bool PreserveSig (par défaut true) : Quand c'est true, la fonction retourne un integer, et quand c'est false, elle retourne une void. Quand une void autre que S_OK (aussi appelé 0, NULL, ERROR_SUCCESS), une exception est lancée. L'exception correspond au code d'erreur. Si la fonction retourne un int autre que 0, vous pouvez gérer l'erreur comme vous le souhaitez.

 

-bool SetLastError (par défaut false) : Si y'a une erreur durant l'utilisation de la fonction, on peut utiliser Marshal.GetLastWin32Error pour obtenir le code de l'erreur (error code)

 

-bool ThrowOnUnmappableChar (par défaut false) : Si c'est a true et qu'une erreur survient durant la conversion des caractères d'UNICODE a ANSI, ça envoie une exception. Sinon ça remplace le caractère par un '?'.

 

Oui y'a beaucoup de paramètres, mais ils sont rarement tous utilisé en même temps.

 

Plateform Invoke

 

 

DLLImport fait partie de la plateforme Invoke (PInvoke).

 

Pour trouver les prototypes des fonctions qu'on veut utiliser, il faut se rendre sur le Microsoft Developer Network (MSDN).

 

Par exemple pour FindWindow, le prototype est : (en C)

HWND WINAPI FindWindow(
  _In_opt_  LPCTSTR lpClassName,
  _In_opt_  LPCTSTR lpWindowName
);

 

Mais on ne peut pas utiliser les types des lib C en C# ... Donc on doit les 'traduire'.

Un superbe site pour ça : pinvoke.net

 

Attention ! Ce site ne contient pas les prototypes de TOUTE les fonctions, n’hésitez pas a utiliser Google.

 

Pour FindWindow le prototype serait donc :

 

static extern IntPtr FindWindow(string lpClassName, string lpWindowName);

 

Un peu de pratique ...

 

Ouvrez Visual Studio, on va commencer a coder. (ah bah enfin ...  )

Ouvrez aussi une application ayant un titre facile a écrire, j'utiliserait Paint.

 

Comme dit précédemment :

using System.Runtime.InteropServices;
// Le 'DLLImport' est habituellement placé au début d'une classe, ou encore dans une classe spécifique. 
 
[DLLImport("user32.dll", SetLastError = true)]
static extern IntPtr  FindWindow(string lpClassName, string lpWindowName); 
//On utilisera lpWindowName, lpClassName restera null.
 
[DllImport("user32.dll", SetLastError = true)]
        static extern bool FlashWindow(IntPtr hwnd, bool bInvert);
//hwnd est l'handle (quelque chose que Windows utilise pour identifier des objets) de la fenêtre, qu'on récupère grâce a FindWindow.

 

Puis après on fait notre propre code :

 

string sWindowName =  "Untitled - Paint";
 IntPtr hWindow = FindWindow(null,sWindowName); // Je préfère utiliser le nom de la fenêtre, donc je place le premier argument a null.
 
    int error = Marshal.GetLastWin32Error(); // Un peu d'error-checking, la liste des ErrorCodes peut être trouvée ici : SystemErrorCodes
            if (error == 0)
            {
                FlashWindow(hWindow, true);
 
                error = Marshal.GetLastWin32Error();
                if (error == 0)
                    Console.WriteLine("{0} flashed !", sWindowName);
                else 
                  Console.WriteLine("ErrorCode = {0}", error); 
            }      
            else
               Console.WriteLine("ErrorCode = {0}", error); // Si il y a une erreur, affiche l'erreur.

 

 

 

End

 

Bon bah voila, je pense que j'ai tout dit sur les bases du DLLImport. Pour plus de lecture : DLLImport Attribute

 

Je n'ai montré que deux API (fonctions dans les DLL de windows), il y en a DES CENTAINES, liste disponible sur le MSDN : Windows API Index

 

Petit projet qui montre quelques trucs possible avec l'api Windows :

-WindowsControl.exe (scan VirusTotal)

-Source (sans l’exécutable, vous devez le compiler vous-même)

 

Si vous avez des questions, des commentaires etc. , n’hésitez pas a les poster ici.

 

En espérant que ça vous aie plu,

 

Davy.

Modifié May 25, 2014 par davydavek

[Azad]

Très bon tutoriel : complet, pédagogique, documenté et avec des sources concrètes.
Mes félicitations, un très bon début.

Surtout que ça peut en intéresser beaucoup, vu les bidouilleurs qu'on a.
+1 rep.