Fonction LoadModule (winbase.h)

Article
08/27/2023

Charge et exécute une application ou crée un instance d’une application existante.

Note Cette fonction est fournie uniquement pour la compatibilité avec les versions 16 bits de Windows. Les applications doivent utiliser la fonction CreateProcess .

Syntaxe

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

Paramètres

[in] lpModuleName

Nom de fichier de l’application à exécuter. Lorsque vous spécifiez un chemin d’accès, veillez à utiliser des barres obliques inverses (\), et non des barres obliques (/). Si le paramètre lpModuleName ne contient pas de chemin de répertoire, le système recherche le fichier exécutable dans cet ordre :

Répertoire à partir duquel l’application a été chargée.
Le répertoire actif.
Répertoire du système. Utilisez la fonction GetSystemDirectory pour obtenir le chemin d’accès de ce répertoire.
Répertoire système 16 bits. Aucune fonction n’obtient le chemin d’accès de ce répertoire, mais elle fait l’objet d’une recherche. Le nom de ce répertoire est System.
Répertoire Windows. Utilisez la fonction GetWindowsDirectory pour obtenir le chemin d’accès de ce répertoire.
Répertoires répertoriés dans la variable d’environnement PATH.

[in] lpParameterBlock

Pointeur vers une structure de LOADPARMS32 définie par l’application qui définit le bloc de paramètres de la nouvelle application.

Définissez tous les membres inutilisés sur NULL, à l’exception de lpCmdLine, qui doit pointer vers une chaîne terminée par null si elle n’est pas utilisée. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Si la fonction réussit, la valeur de retour est supérieure à 31.

Si la fonction échoue, la valeur de retour est une valeur d’erreur, qui peut être l’une des valeurs suivantes.

Code/valeur de retour	Description
0	Le système est en panne de mémoire ou de ressources.
ERROR_BAD_FORMAT 11L	Le fichier .exe n’est pas valide.
ERROR_FILE_NOT_FOUND 2L	Le fichier spécifié est introuvable.
ERROR_PATH_NOT_FOUND 3L	Le chemin spécifié est introuvable.

Remarques

La structure LOADPARMS32 se présente sous la forme suivante :

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;

Membre	Signification
lpEnvAddress	Pointeur vers un tableau de chaînes terminées par null qui fournissent les chaînes d’environnement pour le nouveau processus. Le tableau a la valeur NULL comme dernière entrée. La valeur NULL pour ce paramètre entraîne le démarrage du nouveau processus avec le même environnement que le processus appelant.
lpCmdLine	Pointeur vers une chaîne de style Pascal qui contient une ligne de commande correctement formée. Le premier octet de la chaîne contient le nombre d’octets dans la chaîne. Le reste de la chaîne contient les arguments de ligne de commande, à l’exclusion du nom du processus enfant. S’il n’existe aucun argument de ligne de commande, ce paramètre doit pointer vers une chaîne de longueur nulle ; il ne peut pas être NULL.
lpCmdShow	Pointeur vers une structure contenant deux valeurs WORD . La première valeur doit toujours être définie sur deux. La deuxième valeur spécifie comment la fenêtre d’application doit être affichée et est utilisée pour fournir le membre wShowWindow de la structure STARTUPINFO à la fonction CreateProcess . Pour obtenir la liste des valeurs acceptables, consultez la description du paramètre nCmdShow de la fonction ShowWindow .
dwReserved	Ce paramètre est réservé ; il doit être égal à zéro.

Les applications doivent utiliser la fonction CreateProcess au lieu de LoadModule. La fonction LoadModule appelle CreateProcess en formant les paramètres comme suit.

Paramètre CreateProcess	Argument utilisé
lpszApplicationName	lpModuleName
lpszCommandLine	lpParameterBlock. lpCmdLine
lpProcessAttributes	NULL
lpThreadAttributes	NULL
bInheritHandles	FALSE
dwCreationFlags	0
lpEnvironnement	lpParameterBlock. lpEnvAddress
lpCurrentDirectory	NULL
lpStartupInfo	La structure est initialisée à zéro. Le membre cb est défini sur la taille de la structure. Le membre wShowWindow est défini sur la valeur du deuxième mot de lpParameterBlock. lpCmdShow.
lpProcessInformation.hProcess	Le handle est immédiatement fermé.
lpProcessInformation.hThread	Le handle est immédiatement fermé.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CreateProcess

Fonctions de bibliothèque de liens dynamiques

GetSystemDirectory

GetWindowsDirectory

Share via