• La fonction AppelDLL32 est protégée contre les "Erreurs de protection générale" dans la fonction appelée. Néanmoins, si une erreur de ce type se produit, une erreur WLangage est déclenchée.
• Pour les fonctions au prototype d'appel PASCAL (les fonctions de l'API Windows notamment), un contrôle sommaire du nombre de paramètres passés à la fonction est effectué. En cas de discordance, une erreur WLangage est déclenchée.

Gestion des erreurs

Chargement et déchargement de la DLL

Paramètres à passer à la fonction de la DLL

• Les types "simples" (entier, réel, et booléen). L'utilisation d'un autre type WLangage provoque une erreur du WLangage.
  Si la fonction à exécuter attend un pointeur ou un handle Windows, utilisez un entier système.
  Si la fonction à exécuter attend une adresse, utilisez l'opérateur &.
• Les types "chaîne".
• Les types structure.
• Un nom de procédure WLangage. Cette procédure sera rappelée par la fonction de la DLL (voir paragraphe ci-dessous).
  Les paramètres dépendent de la fonction exécutée. Consultez la documentation de cette fonction pour obtenir plus de détails.

Passer une chaîne à une API ou récupérer une chaîne en retour d'une API

1. En paramètre d'entrée, utilisez le type chaîne. Par exemple :
   
   sChaîne est une chaîne
   AppelDll32(<DLL>, <Fonction>, sChaîne)
2. En paramètre de sortie, le C n'est pas capable de gérer des chaînes dynamiques de manière simple. Il est donc nécessaire :
   • soit de fixer une taille maximale, avec le type "Chaîne sur". Par exemple :
     
     sChaîne est une chaîne sur 100
     AppelDLL32(<DLL>, <Fonction>, sChaîne)
     // dans Methode en C :
     // STRNCPY(PointeurEnC, "Test", 100)
   • soit de récupérer les adresses des chaînes en C (mais dans ce cas, la partie de code en C doit assurer la "survie" des chaînes renvoyées), puis de transférer la chaîne dans une variable de type chaîne grâce à la fonction ChaîneRécupère. Par exemple :
     
     nAdresseChaîne est un entier système
     AppelDLL32(<DLL>, <Fonction>, &nAdresseChaîne)
     sChaîne est une chaîne
     sChaîne = ChaîneRécupère(nAdresseChaîne, crAdresseASCIIZ)
     // dans Méthode en C : *PointeurEnC = "Test"
3. En valeur de retour, récupérer les adresses des chaînes en C (mais dans ce cas, la partie de code en C doit assurer la "survie" des chaînes renvoyées), puis transférer la chaîne dans une variable de type chaîne grâce à la fonction ChaîneRécupère. Par exemple :
   
   nAdresseChaîne est un entier système
   nAdresseChaîne = AppelDLL32(<DLL>, <Fonction>)
   sChaîne est une chaîne
   sChaîne = ChaîneRécupère(nAdresseChaîne, crAdresseASCIIZ)
   // dans Méthode en C : Return PointeurEnC

Passer une structure contenant une chaîne à une API

1. En entrée, le code à utiliser est le suivant :
   
   Struct est une structure
   sChaîne est une chaîne
   FIN
   UneStruct est une Struct
   AppelDLL32(<DLL>, <Fonction>, &UneStruct)
2. En sortie, le C n'est pas capable de gérer des chaînes dynamiques de manière simple. Il est donc nécessaire de :
   • soit fixer une taille maximale et faire une copie dans la mémoire du WLangage. Par exemple :
     
     sChaîne est une chaîne sur 100
     Struct est une structure
     aChaîne est un entier
     FIN
     UneStruct est une Struct
     UneStruct:aChaîne = &sChaîne
     AppelDLL32(<DLL>, <Fonction>, &UneStruct)
     // dans Methode en C :
     // STRNCPY(StructEnC->PointeurEnC, "Test", 100)
   • soit récupérer les adresses des chaînes en C (mais dans ce cas, la partie de code en C doit assurer la "survie" des chaînes renvoyées). Par exemple :
     
     sChaîne est une chaîne
     Struct est une structure
     aChaîne est un entier
     FIN
     UneStruct est une Struct
     AppelDLL32(<DLL>, <Fonction>, &UneStruct)
     sChaîne = ChaîneRécupère(UneStruct:aChaîne, crAdresseASCIIZ)
     // dans Methode en C : StructEnC->PointeurEnC = "Test"

Procédure appelée en CallBack

• Les types doivent correspondre à ceux décrits dans la documentation de l'API.
• La fonction "CallBack" de la DLL doit être de type "stdcall".
• Les paramètres sont obligatoirement passés par valeur. Pour récupérer un paramètre par référence :
  1. Utilisez un entier.
  2. Avec la fonction Transfert, récupérez ou affectez la véritable valeur.

Divers

• Les fonctions API et AppelDLL32 ne bloquent pas les autres threads.
• Si la fonction de l'API appelée modifie les paramètres systèmes régionaux, les paramètres régionaux précédents sont restaurés.

• Les fonctions API et AppelDLL32 bloquent les autres threads.
• Si la fonction de l'API appelée modifie les paramètres systèmes régionaux (langues, décimales, ...), les paramètres régionaux précédents ne sont pas restaurés.