Función LoadModule (winbase.h)

  • Artículo

Carga y ejecuta una aplicación o crea una nueva instancia de una aplicación existente.

Nota Esta función solo se proporciona por compatibilidad con versiones de 16 bits de Windows. Las aplicaciones deben usar la función CreateProcess .
 

Sintaxis

DWORD LoadModule(
  [in] LPCSTR lpModuleName,
  [in] LPVOID lpParameterBlock
);

Parámetros

[in] lpModuleName

Nombre de archivo de la aplicación que se va a ejecutar. Al especificar una ruta de acceso, asegúrese de usar barras diagonales inversas (\), no barras diagonales (/). Si el parámetro lpModuleName no contiene una ruta de acceso de directorio, el sistema busca el archivo ejecutable en este orden:

  1. Directorio desde el que se cargó la aplicación.
  2. El directorio actual.
  3. Directorio del sistema. Use la función GetSystemDirectory para obtener la ruta de acceso de este directorio.
  4. Directorio del sistema de 16 bits. No hay ninguna función que obtenga la ruta de acceso de este directorio, pero se busca. El nombre de este directorio es System.
  5. El directorio de Windows. Use la función GetWindowsDirectory para obtener la ruta de acceso de este directorio.
  6. Los directorios que aparecen en la variable de entorno PATH.

[in] lpParameterBlock

Puntero a una estructura de LOADPARMS32 definida por la aplicación que define el bloque de parámetros de la nueva aplicación.

Establezca todos los miembros no usados en NULL, excepto lpCmdLine, que debe apuntar a una cadena terminada en null si no se usa. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es mayor que 31.

Si se produce un error en la función, el valor devuelto es un valor de error, que puede ser uno de los valores siguientes.

Código o valor devuelto Descripción
0
 El sistema no tiene memoria o recursos.
ERROR_BAD_FORMAT
11L
 El archivo .exe no es válido.
ERROR_FILE_NOT_FOUND
T2l
 No se encontró el archivo especificado.
ERROR_PATH_NOT_FOUND
3L
 No se encontró la ruta de acceso especificada.

Comentarios

La estructura LOADPARMS32 tiene la siguiente forma:

typedef struct tagLOADPARMS32 { 
  LPSTR lpEnvAddress;  // address of environment strings 
  LPSTR lpCmdLine;     // address of command line 
  LPSTR lpCmdShow;     // how to show new program 
  DWORD dwReserved;    // must be zero 
} LOADPARMS32;
Miembro Significado
lpEnvAddress Puntero a una matriz de cadenas terminadas en NULL que proporcionan las cadenas de entorno para el nuevo proceso. La matriz tiene un valor NULL como última entrada. Un valor null para este parámetro hace que el nuevo proceso comience con el mismo entorno que el proceso de llamada.
lpCmdLine Puntero a una cadena de estilo Pascal que contiene una línea de comandos formada correctamente. El primer byte de la cadena contiene el número de bytes de la cadena. El resto de la cadena contiene los argumentos de la línea de comandos, excepto el nombre del proceso secundario. Si no hay argumentos de línea de comandos, este parámetro debe apuntar a una cadena de longitud cero; no puede ser NULL.
lpCmdShow Puntero a una estructura que contiene dos valores DE WORD . El primer valor siempre debe establecerse en dos. El segundo valor especifica cómo se va a mostrar la ventana de la aplicación y se usa para proporcionar el miembro wShowWindow de la estructura STARTUPINFO a la función CreateProcess . Vea la descripción del parámetro nCmdShow de la función ShowWindow para obtener una lista de valores aceptables.
dwReserved Este parámetro está reservado; debe ser cero.
 

Las aplicaciones deben usar la función CreateProcess en lugar de LoadModule. La función LoadModule llama a CreateProcess mediante la formación de los parámetros como se indica a continuación.

Parámetro CreateProcess Argumento usado
lpszApplicationName lpModuleName
lpszCommandLine lpParameterBlock. lpCmdLine
lpProcessAttributes NULL
lpThreadAttributes NULL
bInheritHandles FALSE
dwCreationFlags 0
lpEnvironment lpParameterBlock. lpEnvAddress
lpCurrentDirectory NULL
lpStartupInfo La estructura se inicializa en cero. El miembro cb se establece en el tamaño de la estructura. El miembro wShowWindow se establece en el valor de la segunda palabra de lpParameterBlock. lpCmdShow.
lpProcessInformation.hProcess El controlador se cierra inmediatamente.
lpProcessInformation.hThread El controlador se cierra inmediatamente.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

CreateProcess

Funciones de la biblioteca de vínculos dinámicos

GetSystemDirectory

GetWindowsDirectory