Función de devolución de llamada ENUMRESTYPEPROCA (libloaderapi.h)

Artículo
08/24/2023

Función de devolución de llamada definida por la aplicación que se usa con las funciones EnumResourceTypes y EnumResourceTypesEx . Recibe tipos de recursos. El tipo ENUMRESTYPEPROC define un puntero a esta función de devolución de llamada. EnumResTypeProc es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

ENUMRESTYPEPROCA Enumrestypeproca;

BOOL Enumrestypeproca(
  [in, optional] HMODULE hModule,
                 LPSTR lpType,
  [in]           LONG_PTR lParam
)
{...}

Parámetros

[in, optional] hModule

Tipo: HMODULE

Identificador del módulo cuyo archivo ejecutable contiene los recursos para los que se van a enumerar los tipos. Si este parámetro es NULL, la función enumera los tipos de recursos del módulo que se usan para crear el proceso actual.

lpType

Tipo: LPTSTR

Tipo de recurso para el que se enumera el tipo.

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.

[in] lParam

Tipo: LONG_PTR

Parámetro definido por la aplicación que se pasa a la función EnumResourceTypes o EnumResourceTypesEx . Este parámetro se puede usar en la comprobación de errores.

Valor devuelto

Tipo: BOOL

Devuelve TRUE para continuar la enumeración o FALSE para detener la enumeración.

Comentarios

Si IS_INTRESOURCE(lpszType) es TRUE, lpszType 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.

Una aplicación debe registrar esta función pasando su dirección a la función EnumResourceTypes o EnumResourceTypesEx .

Si la función de devolución de llamada devuelve FALSE, EnumResourceTypes o EnumResourceTypesEx detendrá la enumeración y devolverá FALSE. En Windows XP y versiones anteriores, el valor obtenido de GetLastError será ERROR_SUCCESS; a partir de Windows Vista, se ERROR_RESOURCE_ENUM_USER_STOP el último valor de error.

Nota:

El encabezado libloaderapi.h define ENUMRESTYPEPROC 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	libloaderapi.h (incluye Windows.h)