Syntaxe
USHORT DosChDir(PSZ DirName, ULONG Reserved);
|
Paramètres
Nom |
Description |
DirName |
Ce paramètre permet d'indiquer l'adresse de la chaîne de caractères ASCIZ du nom du chemin de répertoire. |
Reserved |
Ce paramètre doit toujours avoir la valeur 0. |
Retour
Valeur |
Constante |
Description |
0 |
NO_ERROR |
Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
3 |
ERROR_PATH_NOT_FOUND |
Cette valeur permet d'indiquer qu'une erreur de chemin introuvable 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. |
26 |
ERROR_NOT_DOS_DISK |
Cette valeur permet d'indiquer qu'une erreur de disque non-DOS s'est produite. |
87 |
ERROR_INVALID_PARAMETER |
Cette valeur permet d'indiquer qu'un ou plusieurs des paramètres contient une valeur illégale. |
108 |
ERROR_DRIVE_LOCKED |
Cette valeur permet d'indiquer qu'une erreur d'unité verrouillé s'est produite. |
206 |
ERROR_FILENAME_EXCED_RANGE |
Cette valeur permet d'indiquer une erreur de nom de fichier excédant la limite du rang. |
Description
Cette fonction permet de changer le répertoire courant.
Remarques
- Le chemin du répertoire n'est pas modifié si aucun membre du chemin n'existe. Le répertoire actuel ne change que pour le processus demandeur.
- Pour les FSD, la casse du répertoire en cours est définie en fonction du DirName transmis, et non en fonction de la casse des répertoires sur le disque. Par exemple, si le
répertoire «C:\BIN» est créé et que la fonction DosChDir est appelé avec "C:\BIN" dans DirName , le répertoire actuel renvoyé par DosQCurDir sera "C:\BIN".
- Les programmes s'exécutant sans l'ensemble de bits NEWFILES sont autorisés à DosChDir dans un répertoire de format de nom de fichier non 8.3.
- La fonction DosQSysInfo doit être utilisé par une application pour déterminer la longueur de chemin maximale prise en charge par OS/2. La valeur renvoyée doit être
utilisée pour allouer dynamiquement des tampons devant être utilisés pour entreposer des chemins.
Voir également
Langage de programmation - C pour OS/2 - DosQCurDir
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010