Función EnumResourceLanguagesExA (libloaderapi.h)
Enumera los recursos específicos del lenguaje, del tipo y el nombre especificados, asociados a un módulo binario especificado. Extiende EnumResourceLanguages al permitir un mayor control sobre la enumeración.
Sintaxis
BOOL EnumResourceLanguagesExA(
[in] HMODULE hModule,
[in] LPCSTR lpType,
[in] LPCSTR lpName,
[in] ENUMRESLANGPROCA lpEnumFunc,
[in] LONG_PTR lParam,
[in] DWORD dwFlags,
[in] LANGID LangId
);
Parámetros
[in] hModule
Tipo: HMODULE
Identificador de un módulo que se va a buscar. Normalmente se trata de un archivo ejecutable portátil independiente del lenguaje (archivo LN) y, si se establece la marca RESOURCE_ENUM_MUI, los archivos .mui adecuados se incluyen en la búsqueda. Como alternativa, puede ser un identificador de un archivo .mui u otro archivo LN. Si se trata de un archivo .mui específico, solo ese archivo se busca en recursos.
Si este parámetro es NULL, equivale a pasar un identificador al módulo usado para crear el proceso actual.
[in] lpType
Tipo: LPCTSTR de
Tipo del recurso para el que se enumera el idioma. Como alternativa, en lugar de un puntero, este parámetro puede ser MAKEINTRESOURCE(ID), donde ID es un valor entero que representa un tipo de recurso predefinido. Para obtener una lista de los tipos de recursos predefinidos, consulte Tipos de recursos. Para obtener más información
a continuación, consulte la sección Comentarios.
[in] lpName
Tipo: LPCTSTR de
Nombre del recurso para el que se enumera el idioma. Como alternativa, en lugar de un puntero, este parámetro puede ser MAKEINTRESOURCE(ID), donde ID es el identificador entero del recurso. Para obtener más información, vea la sección Comentarios a continuación.
[in] lpEnumFunc
Tipo: ENUMRESLANGPROC
Puntero a la función de devolución de llamada a la que se va a llamar para cada lenguaje de recursos enumerado. Para obtener más información, vea EnumResLangProcA.
[in] lParam
Tipo: LONG_PTR
Valor definido por la aplicación que se pasa a la función de devolución de llamada. Este parámetro se puede usar en la comprobación de errores.
[in] dwFlags
Tipo: DWORD de
Tipo de archivo que se va a buscar. Se admiten los siguientes valores. Tenga en cuenta que si dwFlags es cero, se supone que se especifican las marcas RESOURCE_ENUM_LN y RESOURCE_ENUM_MUI.
[in] LangId
Tipo: LANGID de
Idioma de localización usado para filtrar la búsqueda en el archivo .mui. Este parámetro solo se usa cuando la marca de RESOURCE_ENUM_MUI está establecida en dwFlags. Si se especifica cero, todos los archivos .mui se incluyen en la búsqueda. Si se especifica un
Valor devuelto
Tipo: BOOL de
Devuelve TRUE si la función se ejecuta correctamente o FALSE si la función no encuentra un recurso del tipo especificado o si la función produce un error por otro motivo. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Si IS_INTRESOURCE(lpType) es TRUE, lpType especifica el identificador entero del tipo de recurso especificado. De lo contrario, es un puntero a una cadena terminada en NULL. Si el primer carácter de la cadena es un signo de libra (#), los caracteres restantes representan un número decimal que especifica el
identificador entero del tipo de recurso. Por ejemplo, la cadena "#258" representa el identificador 258.
Del mismo modo, si IS_INTRESOURCE(lpName) es TRUE, lpName especifica el identificador entero del recurso especificado. De lo contrario, es un puntero a una cadena terminada en NULL. Si el primer carácter de la cadena es un signo de libra (#), los caracteres restantes representan un número decimal que especifica el
identificador entero del recurso.
A partir de Windows Vista, el módulo binario suele ser un archivo LN y la enumeración también incluirá recursos de los archivos de recursos específicos del idioma correspondientes (archivos .mui) que contienen recursos de idioma localizables.
Para cada recurso de este tipo encontrado, EnumResourceLanguagesEx llama a una función de devolución de llamada definida por la aplicación lpEnumFunc, pasando a la función de devolución de llamada el identificador de idioma (vea identificadores de idioma) del idioma para el que se encontró un recurso (así como los distintos parámetros que se pasaron a EnumResourceLanguagesEx).
La búsqueda puede incluir un archivo LN y sus archivos .mui asociados, o bien puede limitarse a un único módulo binario de cualquier tipo o a los archivos .mui asociados a un único archivo LN. Además, al especificar un archivo LN para el parámetro hModule y un parámetro langId distinto de cero, la búsqueda puede limitarse al archivo .mui único asociado a ese archivo y lenguaje LN.
La función EnumResourceLanguagesEx
Si hModule especifica un archivo LN y se seleccionan ambas marcas, los idiomas enumerados incluyen todos los idiomas cuyos recursos residen en el archivo LN o en cualquier archivo .mui asociado. Si no se encuentra ningún archivo .mui, solo se devuelven los idiomas del archivo LN.
Si dwFlags contiene RESOURCE_ENUM_MUI o null y LangId es 0, la enumeración incluye primero los idiomas asociados a todos los archivos .mui instalados por el sistema, mediante idiomas recuperados de EnumUILanguages.. Por último, si también se establece la marca RESOURCE_ENUM_LN, también se busca en el archivo designado por hModule.
Si el LangId es distinto de cero, solo se buscará en el archivo .mui correspondiente a ese identificador de idioma. No se usarán las reservaciones de idioma. Si no existe un archivo .mui para ese idioma, la enumeración estará vacía (a menos que existan recursos para ese idioma en el archivo LN y la marca se establezca para buscar también el archivo LN).
La enumeración nunca incluye duplicados: si los recursos de un idioma determinado están contenidos en el archivo LN y en un archivo .mui, el tipo solo se enumerará una vez.
Ejemplos
Para obtener un ejemplo, vea Crear una lista de recursos.
Nota
El encabezado libloaderapi.h define EnumResourceLanguagesEx 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 Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
libloaderapi.h (incluya Windows.h) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |
Consulte también
conceptual de
de referencia de
recursos de