System.SysUtils.SafeLoadLibrary
Delphi
function SafeLoadLibrary(const Filename: string; ErrorMode: UINT): HMODULE;
C++
extern DELPHI_PACKAGE NativeUInt __fastcall SafeLoadLibrary(const System::UnicodeString FileName, unsigned ErrorMode = (unsigned)(0x8000));
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Description
Fonction de chargement de bibliothèque simple et sécurisé.
SafeLoadLibrary charge une bibliothèque liée dynamiquement (DLL) Windows ou un fichier objet partagé MAC OS X, comme spécifié par le paramètre FileName
. SafeLoadLibrary préserve le mot de contrôle FPU en cours, ce qui empêche le code d'initialisation de bibliothèque de remplacer en permanence les masques d'exception et de précision.
Remarque : Sous Windows, SafeLoadLibrary définit temporairement le mode d'erreur système à
ErrorMode
. La valeur par défaut,SEM_NOOPENFILEERRORBOX
, supprime les dialogues d'erreur. Le mode d'erreur précédent est restauré avant la sortie de SafeLoadLibrary. Pour obtenir la liste des modes d'erreur, reportez-vous à la fonction SetErrorMode dans la documentation Microsoft. Sous MAC OS X, le paramètreDummy
est ignoré.
En cas de réussite, SafeLoadLibrary renvoie un handle au module chargé. Sinon, elle renvoie NULL.