Поделиться через


_open_osfhandle

Связывает идентификатор файла С времени выполнения с существующим дескриптором файла операционной системы.

int _open_osfhandle ( 
   intptr_t osfhandle, 
   int flags  
);

Параметры

  • osfhandle
    Дескриптор файла операционной системы.

  • flags
    Типы допустимых операций.

Возвращаемое значение

В случае успеха _open_osfhandle возвращает идентификатор файла времени выполнения С. В противном случае возвращается значение -1.

Заметки

Функция _open_osfhandle выделяет идентификатор файла времени выполнения С и связывает его с дескриптором файла операционной системы osfhandle. Аргумент flags — целочисленное выражение, построенное из одной или нескольких констант манифеста, определенных в Fcntl.h. Если используется две или более константы манифеста для формирования аргумента flags, то константы объединяются с побитовым оператором OR ( | ).

Fcntl.h определяет следующие константы манифеста.

  • _O_APPEND
    Перемещает указатель файла в конец файла перед каждой операцией записи.

  • _O_RDONLY
    Открывает файл только для чтения.

  • _O_TEXT
    Открывает файл в текстовом (преобразованном) режиме.

  • _O_WTEXT
    Открывает файл в режиме Юникод (преобразованном UTF-16).

Чтобы закрыть файл, открытый _open_osfhandle, вызовите _close. Базовый дескриптор также можно закрыть вызовом _close, поэтому не нужно вызывать функцию CloseHandle Win32 для исходного дескриптора.

Требования

Подпрограмма

Обязательный заголовок

_open_osfhandle

<io.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Библиотеки

Все версии библиотек времени выполнения C.

Эквивалент в .NET Framework

System::IO::FileStream::Handle

См. также

Ссылки

Обработка файлов