Langage de programmation - C pour OS/2 - Référence de procédures et de fonctions

DosClose	DOS : Ferme
DOSCALLS.DLL	os2.h

APIRET DosClose(HFILE hFile);

Nom	Description
hFile	Ce paramètre permet d'indiquer l'identificateur de descripteur Handle précédemment retourner par l'une des fonctions DosCreateNPipe, DosCreatePipe, DosDupHandle ou DosOpen.

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.

Cette fonction permet de fermer un fichier d'entrée/sortie Handle.

L'appel de DosClose avec l'identificateur de descripteur Handle vers un fichier ferme un identificateur de descripteur Handle vers un fichier, un canal ou un périphérique.
Si des identificateurs de descripteurs Handle supplémentaires d'un fichier ont été créés avec DosDupHandle, la fonction DosClose doit être émis pour les descripteurs en double avant la mise à jour du répertoire et les informations dans les tampons internes sont écrites sur le support.
La fermeture d'un identificateur de descripteur Handle de périphérique entraîne l'avertissement de la fermeture du périphérique, le cas échéant.
Considérations sur les canaux nommés : la fonction DosClose ferme un tuyau nommé par l'identificateur de descripteur Handle. Lorsque toutes les identificateurs de descripteurs Handle faisant référence à une extrémité d'un tuyau sont fermées, le tuyau est considéré comme cassé.
Si la terminaison client se ferme, aucun autre processus ne peut rouvrir le canal jusqu'à ce que la terminaison de serveur émette DosDisConnectNPipe, suivi de DosConnectNPipe.
Si la terminaison du serveur se ferme alors que le canal est déjà cassé, le canal est immédiatement désalloué; sinon, il n'est pas désalloué tant que le dernier identificateur de descripteur Handle du client n'est pas fermé.

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

Section courante