Función BeginUpdateResourceA (winbase.h)

Artículo
03/08/2023

Recupera un identificador que la función UpdateResource puede usar para agregar, eliminar o reemplazar recursos en un módulo binario.

Sintaxis

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

Parámetros

[in] pFileName

Tipo: LPCTSTR

Archivo binario en el que se van a actualizar los recursos. Una aplicación debe poder obtener acceso de escritura a este archivo; el archivo al que hace referencia pFileName no se puede ejecutar actualmente. Si pFileName no especifica una ruta de acceso completa, el sistema busca el archivo en el directorio actual.

[in] bDeleteExistingResources

Tipo: BOOL

Indica si se van a eliminar los recursos existentes del parámetro pFileName . Si este parámetro es TRUE, los recursos existentes se eliminan y el archivo actualizado incluye solo los recursos agregados con la función UpdateResource . Si este parámetro es FALSE, el archivo actualizado incluye los recursos existentes a menos que se eliminen explícitamente o reemplacen mediante UpdateResource.

Valor devuelto

Tipo: HANDLE

Si la función se ejecuta correctamente, el valor devuelto es un identificador que las funciones UpdateResource y EndUpdateResource pueden usar. El valor devuelto es NULL si el archivo especificado no es pe, el archivo no existe o el archivo no se puede abrir para escribir. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Se recomienda que el archivo de recursos no se cargue antes de llamar a esta función. Sin embargo, si ese archivo ya está cargado, no provocará que se devuelva un error.

Hay algunas restricciones en las actualizaciones de recursos en archivos que contienen datos de configuración de recursos (RC Config): archivos LN y los archivos .mui asociados. Los detalles sobre los tipos de recursos que se pueden actualizar en estos archivos se encuentran en la sección Comentarios de la función UpdateResource .

Esta función puede actualizar los recursos de los módulos que contienen código y recursos. Como se indicó anteriormente, existen restricciones en las actualizaciones de recursos en los archivos LN y los archivos .mui, los cuales contienen datos rc Config; los detalles de las restricciones se encuentran en la referencia de la función UpdateResource .

Ejemplos

Para obtener un ejemplo, consulte Actualización de recursos.

Nota

El encabezado winbase.h define BeginUpdateResource como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll