DosQueryModuleName |
DOS : Requête de nom de module |
DOSCALLS.DLL |
os2.h |
Syntaxe
APIRET DosQueryModuleName(HMODULE hmod, ULONG cbName, PCHAR pch);
|
Paramètres
Nom |
Description |
hmod |
Ce paramètre permet d'indiquer l'identificateur de descripteur du module de lien dynamique étant référencé. Cette identificateur de descripteur est fournie dans le registre DI
lors de l'entrée dans un module, ou lors de l'entrée d'initialisation dans une routine de liaison dynamique. |
cbName |
Ce paramètre permet d'indiquer la longueur maximale du tampon, en octets, où le nom sera entreposé. |
pch |
Ce paramètre permet d'indiquer l'adresse du tampon où les spécifications de fichier du module sont retournées. |
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. |
24 |
ERROR_BAD_LENGTH |
Cette valeur permet d'indiquer que les informations d'une mauvaise longueur. |
Description
Cette fonction permet de demander un chemin complet avec l'unité de disque, le répertoire, le nom de fichier et l'extension associé avec le module Handle référencé.
Remarques
- La fonction DosQueryModuleName renvoie l'unité de disque complet, le chemin, le nom de fichier et l'extension associés au descripteur de module référencé.
- Si le tampon est trop petit, la constante ERROR_BAD_LENGTH est retourné par cette fonction.
Voir également
Langage de programmation - C pour OS/2 - DosLoadModule
Langage de programmation - C pour OS/2 - DosQueryModuleHandle
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010