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

如果函数成功,则返回值为 UpdateResourceEndUpdateResource 函数可以使用的句柄。 如果指定的文件不是 PE,则返回值 NULL,该文件不存在,或者无法打开该文件进行写入。 若要获取扩展的错误信息,请调用 GetLastError

言论

建议在调用此函数之前不加载资源文件。 但是,如果该文件已加载,则不会返回错误。

包含资源配置(RC 配置)数据的文件中的资源更新存在一些限制:LN 文件和关联的 .mui 文件。 有关这些文件中允许更新的资源类型的详细信息,请参阅 UpdateResource 函数的“备注”部分。

此函数可以更新包含代码和资源的模块中的资源。 如上所述,LN 文件和 .mui 文件中的资源更新存在限制,这两者都包含 RC 配置数据;UpdateResource 函数引用中提供了限制的详细信息。

例子

有关示例,请参阅 更新资源

注意

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

要求

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

另请参阅

概念

EndUpdateResource

参考

资源

UpdateResource