LoadPackagedLibrary

指定したパッケージ化モジュールとその依存関係を、呼び出し側プロセスのアドレス空間に読み込む。

LoadPackagedLibrary lpwLibFileName, Reserved

lpwLibFileName : [wstr] 読み込むパッケージ化モジュールのファイル名。モジュールはライブラリモジュール (.dll ファイル) でも実行可能モジュール (.exe ファイル) でもよい。この引数でパスを指定せずにモジュール名のみを指定し、拡張子を省略した場合、関数はモジュール名に既定のライブラリ拡張子 .dll を付加する。.dll の付加を抑止するには、モジュール名の末尾にピリオド (.) を含める。この引数がパスを指定する場合、関数はそのパスでモジュールを検索する。パスは絶対パスや、".." を含む相対パスであってはならない。パスを指定する場合は、スラッシュ (/) ではなく必ずバックスラッシュ (\\) を使用すること。パスの詳細については「ファイル、パス、名前空間の命名」を参照。指定したモジュールが既にプロセス内に読み込まれている場合、関数は読み込み済みモジュールのハンドルを返す。そのモジュールは元々プロセスのパッケージ依存グラフから読み込まれている必要がある。指定したモジュールの読み込みによってシステムが他の関連モジュールを読み込む場合、関数はまず読み込み済みモジュールを検索し、次にプロセスのパッケージ依存グラフを検索する。詳細は「備考」を参照。
Reserved : [int] この引数は予約されている。0 でなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

指定したパッケージ化モジュールとその依存関係を、呼び出し側プロセスのアドレス空間に読み込む。

[戻り値]
関数が成功した場合、戻り値は読み込まれたモジュールのハンドルである。関数が失敗した場合、戻り値は NULL
である。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
LoadPackagedLibrary 関数は LoadLibraryEx
の簡略版である。パッケージ化アプリはパッケージ化モジュールを読み込むために LoadPackagedLibrary
を使用できる。非パッケージアプリケーションは LoadPackagedLibrary
を使用できず、非パッケージアプリケーションがこの関数を呼び出すと APPMODEL_ERROR_NO_PACKAGE
で失敗する。LoadPackagedLibrary
は指定モジュールのハンドルを返し、その参照カウントを増加させる。モジュールが既に読み込まれている場合、関数は読み込み済みモジュールのハンドルを返す。呼び出し側プロセスは、LoadPackagedLibrary
が返したハンドルを GetProcAddress
関数の呼び出しでモジュールの識別に使用できる。読み込み済みモジュールを解放して参照カウントを減少させるには FreeLibrary
関数を使用する。関数が指定モジュールまたはその依存関係を検索する必要がある場合、プロセスのパッケージ依存グラフのみを検索する。これはアプリケーションのパッケージに加え、アプリケーションのパッケージマニフェストの
<Dependencies> セクションに <PackageDependency>
として指定された依存関係である。依存関係はマニフェストに現れた順に検索される。パッケージ依存グラフはアプリケーションのパッケージマニフェストの
<Dependencies> セクションに指定される。依存関係はマニフェストに現れた順に検索される。検索は次のように進む。
（以下省略）

情報