Share via


_get_osfhandle

Retorna o identificador de arquivo de sistema operacional associado ao descritor de baixo nível de arquivo existente.

long _get_osfhandle( 
   int fd 
);

Parâmetros

  • fd
    Descritor de arquivo do usuário.

Valor de retorno

The _get_osfhandle função retorna um identificador de arquivo do sistema operacional se fd (o descritor de arquivo de nível inferior) está no intervalo e internamente é marcado sistema autônomo disponível. Caso contrário, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, esta função retorna INVALID_HANDLE_VALUE (– 1) e define errno para EBADF, que indica um identificador de arquivo inválido.

Comentários

Para fechar um arquivo aberto com _get_osfhandle, ligue para _close. O identificador de base também é fechado por uma telefonar para _close, portanto, não é necessário para chamar a função do Win32 CloseHandle no identificador original.

Requisitos

Rotina

Cabeçalho necessário

_get_osfhandle

<io.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Manipulação de arquivos

_Close

_creat, _wcreat

_dup, _dup2

_Open, _wopen