EndUpdateResourceA 関数 (winbase.h)

  • [アーティクル]

UpdateResource の呼び出しの前に行われた変更をコミットまたは破棄します。

構文

BOOL EndUpdateResourceA(
  [in] HANDLE hUpdate,
  [in] BOOL   fDiscard
);

パラメーター

[in] hUpdate

型: HANDLE

BeginUpdateResource 関数によって返され、更新するファイルを参照する UpdateResource によって使用されるモジュール ハンドル。

[in] fDiscard

種類: BOOL

リソースの更新をファイルに書き込むかどうかを示します。 このパラメーターが TRUE の場合、変更は行われません。 FALSE の場合、変更が加えられます。リソースの更新が有効になります。

戻り値

種類: BOOL

関数が成功した場合は TRUE を返します。 それ 以外の場合は FALSE。 関数が成功し、 fDiscard が TRUE の場合、ファイルに対するリソースの更新は行われません。それ以外の場合は、成功したすべてのリソース更新がファイルに対して行われます。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数を呼び出す前に、 BeginUpdateResource によって返されるファイル ハンドル以外のすべてのファイル ハンドルが閉じられていることを確認します。

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

例

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

注意

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして EndUpdateResource を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

BeginUpdateResource

概念

リファレンス

リソース

UpdateResource