Section courante

A propos

Section administrative du site

DosFreeModule

DOS : Libère la mémoire
DOSCALLS.DLL os2.h

Syntaxe

APIRET DosFreeModule( HMODULE hMod );

Paramètres

Nom Description
hMod Ce paramètre permet d'indiquer l'identificateur Handle à libérer, précédemment alloué par la fonction DosLoadModule.

Retour

Valeur Constante Description
0 NO_ERROR Cette valeur permet d'indiquer que l'opération s'est correctement effectué
6 ERROR_INVALID_HANDLE Cette valeur permet d'indiquer que la valeur du hmuxSemaphore ne point pas sur un sémaphore valide.
12 ERROR_INVALID_ACCESS Cette valeur permet d'indiquer une erreur d'accès invalide.
95 ERROR_INTERRUPT Cette valeur permet d'indiquer qu'une erreur d'interruption s'est produite.

Description

Cette fonction permet de libérer les références du module de lien dynamique pour ce processus et si le module de liaison dynamique n'est utilisé par aucun autre processus, la mémoire occupée par le module est libérée. Par conséquent, aucune fonction du module de liaison dynamique ne peut plus être utilisée.

Remarques

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.     switch(DosFreeModule(hmod)) {
  9.         case NO_ERROR: printf("Tout va bien !");break;
  10.         case ERROR_INVALID_HANDLE: printf("Erreur : La valeur du hmuxSemaphore ne point pas sur un sémaphore valide.");break;
  11.         case ERROR_INVALID_ACCESS: printf("Erreur : Une erreur d'accès invalide.");break;
  12.         case ERROR_INTERRUPT: printf("Erreur : Une erreur d'interruption s'est produite.");break;
  13.     }
  14. }

Voir également

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

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