Función BeginUpdateResourceW (winbase.h)

Artículo
08/27/2023

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

Sintaxis

HANDLE BeginUpdateResourceW(
  [in] LPCWSTR 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 recursos existentes a menos que se eliminen o reemplacen explícitamente 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 escribirlo. 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 los 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, hay restricciones en las actualizaciones de recursos en archivos LN y archivos .mui, ambos que contienen datos de configuración rc; los detalles de las restricciones se encuentran en la referencia de la función UpdateResource .

Ejemplos

Para ver 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll