System.SysUtils.SafeLoadLibrary

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 Vorgabe SEM_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 Parameter Dummy ignoriert.

Bei Erfolg gibt SafeLoadLibrary ein Handle auf das geladene Modul zurück. Ansonsten wird NULL zurückgegeben.

Siehe auch