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));
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
説明
ライブラリの安全かつシンプルな読み込み関数です。
SafeLoadLibrary は、FileName
パラメータで指定された、Windows のダイナミック リンク ライブラリ(DLL)または MAC OS X の共有オブジェクト ファイルを読み込みます。SafeLoadLibrary では、現在の FPU 制御ワードが保持され、精度マスクや例外マスクがライブラリ初期化コードで永久に上書きされることはありません。
メモ: Windows の場合、SafeLoadLibrary はシステムのエラー モードを一時的に
ErrorMode
値に設定します。 デフォルトのSEM_NOOPENFILEERRORBOX
の場合、エラー ダイアログが表示されなくなります。 SafeLoadLibrary が終了する前に、前のエラー モードに戻されます。 エラー モードの一覧については、Microsoft ドキュメントの SetErrorMode 関数を参照してください。 OS X では、Dummy
パラメータは無視されます。
成功した場合、SafeLoadLibrary は、読み込んだモジュールへのハンドルを返します。そうでなければ、NULL を返します。