System.SysUtils.SafeLoadLibrary

De RAD Studio API Documentation
Aller à : navigation, rechercher

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ètre Dummy est ignoré.

En cas de réussite, SafeLoadLibrary renvoie un handle au module chargé. Sinon, elle renvoie NULL.

Voir aussi