Función de devolución de llamada ENUMRESNAMEPROCA (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 EnumResourceNames y EnumResourceNamesEx. Recibe el tipo y el nombre de un recurso. El tipo ENUMRESNAMEPROC define un puntero a esta función de devolución de llamada. EnumResNameProc es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

ENUMRESNAMEPROCA Enumresnameproca;

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

Parámetros

[in, optional] hModule

Tipo: HMODULE

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

lpType

Tipo: LPCTSTR de

Tipo de recurso para el que se enumera el nombre. 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 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.

lpName

Tipo: LPTSTR de

Nombre de un recurso del tipo que se va a enumerar. 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] lParam

Tipo: LONG_PTR

Parámetro definido por la aplicación que se pasa a la función EnumResourceNames o EnumResourceNamesEx. 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.

Del mismo modo, si IS_INTRESOURCE(lpszName) es TRUE, lpszName 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.

Una aplicación debe registrar esta función pasando su dirección a la función EnumResourceNames o EnumResourceNamesEx.

Si la función de devolución de llamada devuelve FALSE, EnumResourceNames o EnumResourceNamesEx 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 ENUMRESNAMEPROC 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)