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

Artículo
11/20/2024

Función de devolución de llamada definida por la aplicación que se usa con las funciones de 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 de

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 ver 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 pasado a la función EnumResourceTypes o EnumResourceTypesEx. Este parámetro se puede usar en la comprobación de errores.

Valor devuelto

Tipo: BOOL de

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

Observaciones

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, el último valor de error será ERROR_RESOURCE_ENUM_USER_STOP.

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 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	libloaderapi.h (incluya Windows.h)