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));
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Beschreibung
Lädt eine Bibliothek.
SafeLoadLibrary lädt eine in FileName
angegebene Windows-DLL oder gemeinsam genutzte OS X-Objektdatei. SafeLoadLibrary behält das aktuelle FPU-Steuerungswort bei und verhindert somit, dass Bibliotheksinitialisierungscode dauerhaft Genauigkeits- und Exception-Masken überschreibt.
Hinweis: Unter Windows setzt SafeLoadLibrary den Systemfehlermodus vorübergehend auf
ErrorMode
. Die VorgabeSEM_NOOPENFILEERRORBOX
unterdrückt Fehlerdialogfelder. Der vorhergehende Fehlermodus wird vor dem Ende von SafeLoadLibrary wiederhergestellt. Eine Liste der Fehlermodi finden Sie unter SetErrorMode in der Microsoft-Dokumentation. Unter OS X wird der ParameterDummy
ignoriert.
Bei Erfolg gibt SafeLoadLibrary ein Handle auf das geladene Modul zurück. Ansonsten wird NULL zurückgegeben.