Compartilhar via


_open_osfhandle

Associa o descritor de arquivo de tempo de execução c com um identificador de arquivo do sistema operacional existente.

int _open_osfhandle ( 
   intptr_t osfhandle, 
   int flags  
);

Parâmetros

  • osfhandle
    Identificador de arquivo do sistema operacional.

  • flags
    Tipos de operações permitidos.

Valor de retorno

Se tiver êxito, _open_osfhandle retorna o descritor de arquivo de tempo de execução c. Caso contrário, retornará – 1.

Comentários

A função de _open_osfhandle atribui o descritor de arquivo de tempo de execução c e associe-o com o identificador de arquivo do sistema operacional especificado por osfhandle. O argumento de flags é uma expressão de inteiro formada de uma ou mais das constantes manifestas definidas em Fcntl.h. Quando duas ou mais manifestas constantes são usadas para formar o argumento de flags , as constantes são combinadas com AND bit a bit OR (o operador | ).

Fcntl.h define as seguintes constantes manifestas.

  • _O_APPEND
    Posiciona um ponteiro de arquivo ao final do arquivo antes de cada operação de gravação.

  • _O_RDONLY
    Abre o arquivo para somente leitura.

  • _O_TEXT
    Abre o arquivo no modo de texto traduzido ().

  • _O_WTEXT
    Abre o arquivo no modo de Unicode (UTF-16 convertido).

Para fechar um arquivo aberto com _open_osfhandle, chame _close. O identificador subjacente também é fechada por uma chamada a _closeportanto, não é necessário chamar a função CloseHandle do Win32 no identificador original.

Requisitos

Rotina

Cabeçalho necessário

_open_osfhandle

<io.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Bibliotecas

Todas as versões das Bibliotecas em tempo de execução C.

Equivalência do .NET Framework

System::IO::FileStream::Handle

Consulte também

Referência

Manipulação de arquivos