Section courante

A propos

Section administrative du site

DosLoadModule

DOS : Charge un module
DOSCALLS.DLL os2.h

Syntaxe

APIRET DosLoadModule( PSZ pszObjectNameBuffer, ULONG ulObjectNameBufferLength , PSZ pszModuleName, PHMODULE phMod );

Paramètres

Nom Description
pszObjectNameBuffer Ce paramètre permet d'indiquer l'adresse du tampon dans lequel un échec de nom d'objet est placé.
ulObjectNameBufferLength Ce paramètre permet d'indiquer la taille de la variable pszObjectNameBuffer.
pszModuleName Ce paramètre permet d'indiquer le nom d'une DLL à chargé.
phMod Ce paramètre permet d'indiquer le pointeur Handle d'un module.

Retour

Valeur Constante Description
0 NO_ERROR Cette valeur permet d'indiquer que l'opération s'est correctement effectué
2 ERROR_FILE_NOT_FOUND Cette valeur permet d'indiquer qu'une erreur de fichier introuvable s'est produite.
3 ERROR_PATH_NOT_FOUND Cette valeur permet d'indiquer qu'une erreur de chemin introuvable s'est produite.
4 ERROR_TOO_MANY_OPEN_FILES Cette valeur permet d'indiquer qu'une erreur de trop de fichier ouvert simultanément s'est produite.
5 ERROR_ACCESS_DENIED Cette valeur permet d'indiquer qu'une erreur d'accès refusé s'est produite.
8 ERROR_NOT_ENOUGH_MEMORY Cette valeur permet d'indiquer que la limite de mémoire système est atteinte.
11 ERROR_BAD_FORMAT Cette valeur permet d'indiquer qu'une erreur de mauvais format s'est produite.
26 ERROR_NOT_DOS_DISK Cette valeur permet d'indiquer qu'une erreur de disque non-DOS s'est produite.
32 ERROR_SHARING_VIOLATION Cette valeur permet d'indiquer qu'une erreur de violation de partage s'est produite.
33 ERROR_LOCK_VIOLATION Cette valeur permet d'indiquer qu'une erreur de violation de verroue s'est produite.
36 ERROR_SHARING_BUFFER_EXCEEDED Cette valeur permet d'indiquer qu'une erreur de dépassement de limite de tampon partagé s'est produite.
95 ERROR_INTERRUPT Cette valeur permet d'indiquer qu'une erreur d'interruption s'est produite.
108 ERROR_DRIVE_LOCKED Cette valeur permet d'indiquer qu'une erreur d'unité verrouillé s'est produite.
127 ERROR_PROC_NOT_FOUND Cette valeur permet d'indiquer qu'une procédure est introuvable.
180 ERROR_INVALID_SEGMENT_NUMBER Cette valeur permet d'indiquer qu'une erreur de nombre de segment invalide s'est produit.
182 ERROR_INVALID_ORDINAL Cette valeur permet d'indiquer un ordinal invalide.
190 ERROR_INVALID_MODULETYPE Cette valeur permet d'indiquer un type de module invalide.
191 ERROR_INVALID_EXE_SIGNATURE Cette valeur permet d'indiquer une signature d'exécutable invalide.
192 ERROR_EXE_MARKED_INVALID Cette valeur permet d'indiquer une erreur de marque d'exécutable invalide s'est produite.
194 ERROR_ITERATED_DATA_EXCEEDS_64K Cette valeur permet d'indiquer une erreur de données excédant la limite de 64 Ko se produit.
195 ERROR_INVALID_MINALLOCSIZE Cette valeur permet d'indiquer une erreur de taille d'allocation minimum invalide.
196 ERROR_DYNLINK_FROM_INVALID_RING Cette valeur permet d'indiquer une erreur de lien dynamique invalide dans l'anneau.
198 ERROR_INVALID_SEGDPL Cette valeur permet d'indiquer une erreur de segment DPL invalide.
199 ERROR_AUTODATASEG_EXCEEDS_64K Cette valeur permet d'indiquer une erreur de segment de données dépassant la limite 64 Ko.
201 ERROR_RELOCSRC_CHAIN_EXCEEDS_SEGLIMIT Cette valeur permet d'indiquer une erreur de relocalisation d'une source excédant la limite de segment.
206 ERROR_FILENAME_EXCED_RANGE Cette valeur permet d'indiquer une erreur de nom de fichier excédant la limite du rang.
295 ERROR_INIT_ROUTINE_FAILED Cette valeur permet d'indiquer une erreur d'initialisation de routine a échoué.

Description

Cette fonction permet d'essayer de charger un module de lien dynamique.

Exemple

Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :

  1. #define INCL_DOSERRORS
  2. #define INCL_DOSMODULEMGR
  3. #include "os2.h"
  4. #include "stdio.h"
  5.  
  6. void main(void) {
  7.     HMODULE hmod;
  8.     UCHAR szErrorName[CCHMAXPATH]; 
  9.     switch(DosLoadModule(szErrorName, CCHMAXPATH-1, ".\\mondll.dll", &hmod)) {
  10.         case NO_ERROR: printf("Tout va bien !");break;
  11.         case ERROR_FILE_NOT_FOUND: printf("Erreur : Une erreur de fichier introuvable s'est produite.");break;
  12.         case ERROR_PATH_NOT_FOUND: printf("Erreur : Une erreur de chemin introuvable s'est produite.");break;
  13.         case ERROR_TOO_MANY_OPEN_FILES: printf("Erreur : Une erreur de trop de fichier ouvert simultanément s'est produite.");break;
  14.         case ERROR_ACCESS_DENIED: printf("Erreur : Une erreur d'accès refusé s'est produite.");break;
  15.         case ERROR_NOT_ENOUGH_MEMORY: printf("Erreur : La limite de mémoire système est atteinte.");break;
  16.         case ERROR_BAD_FORMAT: printf("Erreur : Une erreur de mauvais format s'est produite.");break;
  17.         case ERROR_NOT_DOS_DISK: printf("Erreur : Une erreur de disque non-DOS s'est produite.");break;
  18.         case ERROR_SHARING_VIOLATION: printf("Erreur : Une erreur de violation de partage s'est produite.");break;
  19.         case ERROR_LOCK_VIOLATION: printf("Erreur : Une erreur de violation de verroue s'est produite.");break;
  20.         case ERROR_SHARING_BUFFER_EXCEEDED: printf("Erreur : Une erreur de dépassement de limite de tampon partagé s'est produite.");break;
  21.         case ERROR_INTERRUPT: printf("Erreur : Une erreur d'interruption s'est produite.");break;
  22.         case ERROR_DRIVE_LOCKED: printf("Erreur : Une erreur d'unité verrouillé s'est produite.");break;
  23.         case ERROR_PROC_NOT_FOUND: printf("Erreur : Une procédure est introuvable.");break;
  24.         case ERROR_INVALID_SEGMENT_NUMBER: printf("Erreur : Une erreur de nombre de segment invalide s'est produit.");break;
  25.         case ERROR_INVALID_ORDINAL: printf("Erreur : Un ordinal invalide.");break;
  26.         case ERROR_INVALID_MODULETYPE: printf("Erreur : Un type de module invalide.");break;
  27.         case ERROR_INVALID_EXE_SIGNATURE: printf("Erreur : Une signature d'exécutable invalide.");break;
  28.         case ERROR_EXE_MARKED_INVALID: printf("Erreur : Une erreur de marque d'exécutable invalide s'est produite.");break;
  29.         case ERROR_ITERATED_DATA_EXCEEDS_64K: printf("Erreur : Une erreur de données excédant la limite de 64 Ko se produit.");break;
  30.         case ERROR_INVALID_MINALLOCSIZE: printf("Erreur : Une erreur de taille d'allocation minimum invalide.");break;
  31.         case ERROR_DYNLINK_FROM_INVALID_RING: printf("Erreur : Une erreur de lien dynamique invalide dans l'anneau.");break;
  32.         case ERROR_INVALID_SEGDPL: printf("Erreur : Une erreur de segment DPL invalide.");break;
  33.         case ERROR_AUTODATASEG_EXCEEDS_64k: printf("Erreur : Une erreur de segment de données dépassant la limite 64 Ko.");break;
  34.         case ERROR_RELOC_CHAIN_XEEDS_SEGLIM: printf("Erreur : Une erreur de relocalisation d'une source exécédant la limite de segment.");break;
  35.         case ERROR_FILENAME_EXCED_RANGE: printf("Erreur : Une erreur de nom de fichier excédant la limite du rang.");break;
  36.         case ERROR_INIT_ROUTINE_FAILED: printf("Erreur : Une erreur d'initialisation de routine a échoué.");break;
  37.     }
  38. }

Voir également

Langage de programmation - C pour OS/2 - DosFreeModule
Langage de programmation - C pour OS/2 - DosQueryProcAddr
Système d'exploitation - OS/2 - Introduction

Dernière mise à jour : Lundi, le 19 juillet 2010