Syntaxe
USHORT DosBufReset(HFILE FileHandle);
|
Paramètres
Nom |
Description
|
FileHandle |
Ce paramètre permet d'indiquer le Handle du fichier où les tampons doivent être vidé. |
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. |
5 |
ERROR_ACCESS_DENIED |
Cette valeur permet d'indiquer qu'une erreur d'accès refusé s'est produite. |
6 |
ERROR_INVALID_HANDLE |
Cette valeur permet d'indiquer que la valeur du hmuxSemaphore ne point pas sur un sémaphore valide. |
Description
Cette fonction permet de retourner un ERROR_BROKEN_PIPE si le Handle est un tuyau nommé étant déjà fermé.
Remarques
- Lors de l'émission de l'appel de la fonction DosBufReset pour un descripteur de fichier, les tampons du fichier sont vidés sur le disque et son entrée de répertoire est mise à jour
comme si le fichier avait été fermé; cependant, le fichier reste dans un état ouvert.
- L'utilisation de cet appel pour écrire tous les fichiers appartenant au processus de demande doit être administrée avec prudence. Lorsque les fichiers résident sur des supports amovibles
(disquettes), un appel à la fonction DosBufReset peut avoir pour effet indésirable d'obliger l'utilisateur à insérer et à retirer un grand nombre de disquettes.
- Considérations relatives aux canaux nommés : L'émission de l'appel de la fonction DosBufReset pour un canal nommé effectue une opération étant similaire à forcer le
cache de tampon sur le disque. La demande bloque le processus appelant à une extrémité du canal jusqu'à ce que toutes les données qu'elle a écrites aient été lues à l'autre extrémité du
canal.
Voir également
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010