BeginUpdateResourceW

バイナリモジュール内のリソースを追加、削除、または置換するために UpdateResource 関数で使えるハンドルを取得する。(Unicode)

BeginUpdateResourceW pFileName, bDeleteExistingResources

pFileName : [wstr] 型: LPCTSTR リソースを更新するバイナリファイル。アプリケーションはこのファイルに対する書き込みアクセスを取得できる必要がある。pFileName が参照するファイルは現在実行中であってはならない。pFileName が完全パスを指定しない場合、システムは現在のディレクトリでファイルを検索する。
bDeleteExistingResources : [int] 型: BOOL pFileName パラメータの既存リソースを削除するかどうかを示す。TRUE の場合、既存リソースは削除され、更新後のファイルには UpdateResource で追加されたリソースのみが含まれる。FALSE の場合、更新後のファイルには UpdateResource で明示的に削除または置換されない限り既存のリソースが含まれる。

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

解説

バイナリモジュール内のリソースを追加、削除、または置換するために UpdateResource
関数で使えるハンドルを取得する。(Unicode)

[戻り値]
型: HANDLE 関数が成功した場合、戻り値は UpdateResource および EndUpdateResource
関数で使用できるハンドル。指定されたファイルが PE でない、ファイルが存在しない、またはファイルが書き込み用に開けない場合、戻り値は
NULL。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]

この関数を呼ぶ前にリソースファイルがロードされていないことが推奨される。ただし、すでにロードされていてもエラーは返されない。Resource
Configuration (RC Config) データを含むファイル（LN ファイルと関連する .mui
ファイル）におけるリソース更新にはいくつかの制限がある。これらのファイルでどの種類のリソースを更新できるかの詳細は
UpdateResource
関数の備考セクションを参照。この関数はコードとリソースを両方含むモジュール内のリソースを更新できる。上述のとおり、LN ファイルと
.mui ファイル（どちらも RC Config データを含む）でのリソース更新には制限があり、詳細は UpdateResource
関数のリファレンスを参照。

情報