Función GetModuleHandleA (libloaderapi.h)

Recupera un identificador de módulo para el módulo especificado. El proceso de llamada debe haber cargado el módulo.

Para evitar las condiciones de carrera descritas en la sección Comentarios, use la función GetModuleHandleEx.

Sintaxis

HMODULE GetModuleHandleA(
  [in, optional] LPCSTR lpModuleName
);

Parámetros

[in, optional] lpModuleName

Nombre del módulo cargado (ya sea un archivo .dll o .exe). Si se omite la extensión de nombre de archivo, se anexa la extensión de biblioteca predeterminada .dll. La cadena de nombre de archivo puede incluir un carácter de punto final (.) para indicar que el nombre del módulo no tiene extensión. La cadena no tiene que especificar una ruta de acceso. Al especificar una ruta de acceso, asegúrese de usar barras diagonales inversas (\), no barras diagonales (/). El nombre se compara (mayúsculas y minúsculas de forma independiente) con los nombres de los módulos asignados actualmente al espacio de direcciones del proceso de llamada.

Si este parámetro es NULL, getModuleHandle devuelve un identificador al archivo usado para crear el proceso de llamada (.exe archivo).

La función GetModuleHandle no recupera identificadores de los módulos cargados mediante la marca LOAD_LIBRARY_AS_DATAFILE. Para obtener más información, vea LoadLibraryEx.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador del módulo especificado.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

El identificador devuelto no es global o heredable. Otro proceso no puede duplicarlo ni usarlo.

Si lpModuleName no incluye una ruta de acceso y hay más de un módulo cargado con el mismo nombre base y extensión, no puede predecir qué identificador de módulo se devolverá. Para solucionar este problema, puede especificar una ruta de acceso, usar ensamblados en paraleloo usar GetModuleHandleEx para especificar una ubicación de memoria en lugar de un nombre DLL.

La función GetModuleHandle devuelve un identificador a un módulo asignado sin incrementar su recuento de referencias. Sin embargo, si este identificador se pasa a la función freeLibrary de , se disminuirá el recuento de referencias del módulo asignado. Por lo tanto, no pase un identificador devuelto por GetModuleHandle a la función FreeLibrary. Si lo hace, puede hacer que un módulo DLL se desasignación prematuramente.

Esta función se debe usar cuidadosamente en una aplicación multiproceso. No hay ninguna garantía de que el identificador del módulo permanezca válido entre el momento en que esta función devuelve el identificador y la hora en que se usa. Por ejemplo, supongamos que un subproceso recupera un identificador de módulo, pero antes de usar el identificador, un segundo subproceso libera el módulo. Si el sistema carga otro módulo, podría reutilizar el identificador del módulo que se liberó recientemente. Por lo tanto, el primer subproceso tendría un identificador para un módulo diferente al previsto.

Ejemplos

Para obtener un ejemplo, vea Usar pinceles.

Nota

El encabezado libloaderapi.h define GetModuleHandle 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 XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [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

funciones de biblioteca de Dynamic-Link

FreeLibrary

GetModuleFileName

GetModuleHandleEx

loadLibrary

LoadLibraryEx