Función GetModuleHandleExW (libloaderapi.h)
Recupera un identificador de módulo para el módulo especificado e incrementa el recuento de referencias del módulo a menos que se especifique GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT. El proceso de llamada debe haber cargado el módulo.
Sintaxis
BOOL GetModuleHandleExW(
[in] DWORD dwFlags,
[in, optional] LPCWSTR lpModuleName,
[out] HMODULE *phModule
);
Parámetros
[in] dwFlags
Este parámetro puede ser cero o uno o varios de los valores siguientes. Si se incrementa el recuento de referencias del módulo, el autor de la llamada debe usar la función FreeLibrary para disminuir el recuento de referencias cuando el identificador del módulo ya no sea necesario.
GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS (0x00000004)
El parámetro lpModuleName es una dirección del módulo.
GET_MODULE_HANDLE_EX_FLAG_PIN (0x00000001)
El módulo permanece cargado hasta que finaliza el proceso, independientemente de cuántas veces se llame a FreeLibrary.
Esta opción no se puede usar con GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT.
GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT (0x00000002)
El recuento de referencias del módulo no se incrementa. Esta opción es equivalente al comportamiento de GetModuleHandle. No pase el identificador del módulo recuperado a la función de freeLibrary
Esta opción no se puede usar con GET_MODULE_HANDLE_EX_FLAG_PIN.
[in, optional] lpModuleName
El nombre del módulo cargado (ya sea un archivo .dll o .exe) o una dirección del módulo (si dwFlags es GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS).
Para un nombre de módulo, 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, la función devuelve un identificador al archivo usado para crear el proceso de llamada (.exe archivo).
[out] phModule
Identificador del módulo especificado. Si se produce un error en la función, este parámetro es NULL.
La función
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, vea 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 especificar una ubicación de memoria en lugar de un nombre DLL en el parámetro lpModuleName.
Si
Si dwFlags contiene GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT, esta función debe usarse 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, 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.
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0501 o posterior. Para obtener más información, vea Using the Windows Headers.
Nota
El encabezado libloaderapi.h define GetModuleHandleEx 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