BeginUpdateResourceA 関数 (winbase.h)

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

構文

HANDLE BeginUpdateResourceA(
  [in] LPCSTR pFileName,
  [in] BOOL   bDeleteExistingResources
);

パラメーター

[in] pFileName

型: LPCTSTR

リソースを更新するバイナリ ファイル。 アプリケーションは、このファイルへの書き込みアクセスを取得できる必要があります。pFileName によって参照されているファイルを現在実行中にすることはできません。 pFileName で完全なパスが指定されていない場合、システムは現在のディレクトリ内のファイルを検索します。

[in] bDeleteExistingResources

型: BOOL

pFileName パラメーターの既存のリソースを削除するかどうかを示します。 このパラメーターが TRUE場合、既存のリソースが削除され、更新されたファイルには、UpdateResource 関数で追加されたリソースのみが含まれます。 このパラメーターが FALSE場合、UpdateResourceを使用して明示的に削除または置換されない限り、更新されたファイルには既存のリソース 含まれます。

戻り値

型: HANDLE

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

備考

この関数を呼び出す前に、リソース ファイルを読み込まないことをお勧めします。 ただし、そのファイルが既に読み込まれている場合、エラーは返されません。

リソース構成 (RC Config) データを含むファイルのリソース更新には、LN ファイルと関連する .mui ファイルに関するいくつかの制限があります。 これらのファイルで更新できるリソースの種類の詳細については、UpdateResource 関数の「解説」セクションを参照してください。

この関数は、コードとリソースの両方を含むモジュール内のリソースを更新できます。 前述のように、LN ファイルと .mui ファイルのリソース更新には制限があり、両方に RC Config データが含まれています。制限の詳細については、UpdateResource 関数のリファレンスを参照してください。

例

例については、「リソースの更新を する」を参照してください。

必要条件

関連項目

概念

EndUpdateResource の

リファレンス

リソース

UpdateResource の