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 配置) 数据的文件的资源更新存在一些限制：LN 文件和关联的 .mui 文件。 有关这些文件中允许更新的资源类型的详细信息，请参阅 UpdateResource 函数的“备注”部分。

此函数可以更新同时包含代码和资源的模块中的资源。 如上所述，LN 文件和 .mui 文件中的资源更新存在限制，这两者都包含 RC 配置数据;有关限制的详细信息，请参阅 UpdateResource 函数的参考。

示例

有关示例，请参阅 更新资源。

注意

winbase.h 标头将 BeginUpdateResource 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

概念性

EndUpdateResource

引用

资源

UpdateResource