DosSetFilePtr |
DOS : Fixe le pointeur de fichier |
---|---|
DOSCALLS.DLL | os2.h |
Syntaxe
APIRET DosSetFilePtr(HFILE hFile, LONG ib, ULONG method, PULONG ibActual); |
Paramètres
Nom | Description | ||
---|---|---|---|
hFile | Ce paramètre permet d'indiquer l'identificateur de descripteur Handle retourné par une fonction DosOpen précédente. | ||
ib | Ce paramètre permet d'indiquer la distance de déplacement en octets. | ||
method | Ce paramètre permet d'indiquer la méthode de déplacement. Ce paramètre permet d'indiquer un emplacement dans le fichier, à partir duquel le paramètre ib définit la position de début du déplacement du pointeur de lecture et d'écriture. Les valeurs et leurs significations sont décrites dans la liste suivante : | ||
Valeur | Constante | Description | |
0 | FILE_BEGIN | Cette valeur permet de déplacer le pointeur depuis le début du fichier. | |
1 | FILE_CURRENT | Cette valeur permet de déplacer le pointeur de l'emplacement actuel du pointeur de lecture et d'écriture. | |
2 | FILE_END | Cette valeur permet de déplacer le pointeur vers la fin du fichier. Utilisez cette méthode pour déterminer la taille d'un fichier. | |
ibActual | Ce paramètre permet d'indiquer l'adresse du nouvel emplacement du pointeur. |
Description
Cette fonction permet de déplacer le pointeur de positionnement de lecture ou d'écriture d'un fichier en accord avec le type de déplacement spécifié.
Remarques
- Le pointeur de lecture et d'écriture dans un fichier est un nombre signé de 32 bits. Une valeur négative pour le paramètre ib déplace le pointeur vers l'arrière dans le fichier; une valeur positive le fait avancer. La fonction DosSetFilePtr ne peut pas être utilisé pour passer à une position négative dans le fichier.
- La fonction DosSetFilePtr ne peut pas être utilisé pour un périphérique de caractères ou un canal.
Voir également
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010