Función FindResourceA (winbase.h)

Artículo
03/08/2023

Determina la ubicación de un recurso con el tipo y el nombre especificados en el módulo especificado.

Para especificar un lenguaje, use la función FindResourceEx .

Sintaxis

HRSRC FindResourceA(
  [in, optional] HMODULE hModule,
  [in]           LPCSTR  lpName,
  [in]           LPCSTR  lpType
);

Parámetros

[in, optional] hModule

Tipo: HMODULE

Identificador del módulo cuyo archivo ejecutable portátil o un archivo MUI adjunto contiene el recurso. Si este parámetro es NULL, la función busca en el módulo usado para crear el proceso actual.

[in] lpName

Tipo: LPCTSTR

Nombre del recurso. 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] lpType

Tipo: LPCTSTR

El tipo de recurso. Como alternativa, en lugar de un puntero, este parámetro puede ser MAKEINTRESOURCE(ID), donde ID es el identificador entero del tipo de recurso especificado. Para los tipos de recursos estándar, consulte Tipos de recursos. Para obtener más información, vea la sección Comentarios a continuación.

Valor devuelto

Tipo: HRSRC

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el bloque de información del recurso especificado. Para obtener un identificador para el recurso, pase este identificador a la función LoadResource .

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si IS_INTRESOURCE es TRUE para x = lpName o lpType, x especifica el identificador entero del nombre o tipo del recurso especificado. De lo contrario, esos parámetros son punteros largos a cadenas terminadas 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 nombre o tipo del recurso. Por ejemplo, la cadena "#258" representa el identificador entero 258.

Para reducir la cantidad de memoria necesaria para un recurso, una aplicación debe hacer referencia a él por identificador entero en lugar de por nombre.

Una aplicación puede usar FindResource para buscar cualquier tipo de recurso, pero esta función solo se debe usar si la aplicación debe tener acceso a los datos de recursos binarios realizando llamadas posteriores a LoadResource y, a continuación, a LockResource.

Para usar un recurso inmediatamente, una aplicación debe usar una de las siguientes funciones específicas del recurso para buscar el recurso y convertir los datos en un formulario más utilizable.

Función	Acción
FormatMessage	Carga y da formato a una entrada de tabla de mensajes.
LoadAccelerators	Carga una tabla de aceleradores.
LoadBitmap	Carga un recurso de mapa de bits.
LoadCursor	Carga un recurso de cursor.
LoadIcon	Carga un recurso de icono.
LoadMenu	Carga un recurso de menú.
LoadString	Carga una entrada de tabla de cadenas.

Por ejemplo, una aplicación puede usar la función LoadIcon para cargar un icono para mostrarlo en la pantalla. Sin embargo, la aplicación debe usar FindResource y LoadResource si carga el icono para copiar sus datos en otra aplicación.

Los recursos de cadena se almacenan en secciones de hasta 16 cadenas por sección. Las cadenas de cada sección se almacenan como una secuencia de cadenas Unicode con recuento (no necesariamente terminadas en null). La función LoadString extraerá el recurso de cadena de su sección correspondiente.

Ejemplos

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

Requisitos

Requisito	Value
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