Función BeginUpdateResourceA (winbase.h)
Recupera un identificador que puede usar la función UpdateResource 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 de
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 de
Indica si se van a eliminar los recursos existentes del parámetro pFileName. Si este parámetro es TRUE, se eliminan los recursos existentes y el archivo actualizado solo incluye 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 de
Si la función se ejecuta correctamente, el valor devuelto es un identificador que se puede usar en las funciones UpdateResource y EndUpdateResource. 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.
Observaciones
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 qué tipos de recursos se pueden actualizar en estos archivos se encuentran en la sección Comentarios de la función UpdateResource de
Esta función puede actualizar los recursos dentro 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 de
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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winbase.h (incluya Windows.h) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |
Consulte también
conceptual de
de referencia de
recursos de