BeginUpdateResourceA 関数 (winbase.h)
UpdateResource 関数でバイナリ モジュール内のリソースを追加、削除、または置換するために使用できるハンドルを取得します。
構文
HANDLE BeginUpdateResourceA(
[in] LPCSTR pFileName,
[in] BOOL bDeleteExistingResources
);
パラメーター
[in] pFileName
型: LPCTSTR
リソースを更新するバイナリ ファイル。 アプリケーションは、このファイルへの書き込みアクセスを取得できる必要があります。pFileName によって参照されているファイルを現在実行中にすることはできません。 pFileName で完全なパスが指定されていない場合、システムは現在のディレクトリ内のファイルを検索します。
[in] bDeleteExistingResources
型: BOOL
pFileName パラメーターの既存のリソースを削除するかどうかを示します。 このパラメーターが TRUE
戻り値
型: HANDLE
関数が成功した場合、戻り値は、
備考
この関数を呼び出す前に、リソース ファイルを読み込まないことをお勧めします。 ただし、そのファイルが既に読み込まれている場合、エラーは返されません。
リソース構成 (RC Config) データを含むファイルのリソース更新には、LN ファイルと関連する .mui ファイルに関するいくつかの制限があります。 これらのファイルで更新できるリソースの種類の詳細については、UpdateResource 関数の「解説」セクションを参照してください。
この関数は、コードとリソースの両方を含むモジュール内のリソースを更新できます。 前述のように、LN ファイルと .mui ファイルのリソース更新には制限があり、両方に RC Config データが含まれています。制限の詳細については、UpdateResource 関数のリファレンスを参照してください。
例
例については、「リソースの更新を
手記
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして BeginUpdateResource を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winbase.h (Windows.h を含む) |
ライブラリ | Kernel32.lib |
DLL | Kernel32.dll |
関連項目
概念
EndUpdateResource の
リファレンス
UpdateResource の