System.SysUtils.SafeLoadLibrary

提供: RAD Studio API Documentation
移動先: 案内検索

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 を返します。

関連項目