_open_osfhandle

Associe un descripteur de fichier runtime C à un handle de fichier de système d’exploitation existant.

Syntaxe

int _open_osfhandle (
   intptr_t osfhandle,
   int flags
);

Paramètres

osfhandle
Handle de fichier du système d’exploitation.

flags
Types d’opération autorisés.

Valeur retournée

En cas de réussite, _open_osfhandle retourne un descripteur de fichier Runtime C. Sinon, retourne -1.

Notes

La _open_osfhandle fonction alloue un descripteur de fichier runtime C. Il associe ce descripteur de fichier au handle de fichier du système d’exploitation spécifié par osfhandle. Pour éviter un avertissement du compilateur, convertissez l’argument osfhandle HANDLE en intptr_t. L’argument flags est une expression entière formée à partir d’une ou plusieurs constantes de manifeste définies dans <fcntl.h>. Vous pouvez utiliser l’opérateur « ou » au| niveau du bit pour combiner deux constantes manifestes ou plus pour former l’argument flags .

Ces constantes de manifeste sont définies dans <fcntl.h>:

L’appel _open_osfhandle transfère la propriété du handle de fichier Win32 au descripteur de fichier. Pour fermer un fichier ouvert à l’aide _open_osfhandlede , appelez _close. Le handle de fichier de système d’exploitation sous-jacent est également fermé par un appel à _close. N’appelez pas la fonction CloseHandle Win32 sur le handle d’origine. Si le descripteur de fichier appartient à un FILE * flux, un appel pour fclose fermer le descripteur de fichier et le handle sous-jacent. Dans ce cas, n’appelez _close pas le descripteur de fichier ou CloseHandle sur le handle d’origine.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

Gestion des fichiers
_get_osfhandle