Compartilhar via


CFile::Seek

Reposiciona o ponteiro do arquivo em um arquivo aberto.

virtual ULONGLONG Seek(
   LONGLONG lOff,
   UINT nFrom 
);

Parâmetros

  • lOff
    Número de bytes para mover o ponteiro do arquivo. Os valores positivos mover o ponteiro do arquivo para o final do arquivo; os valores negativos mover o ponteiro do arquivo para o início do arquivo.

  • nFrom
    Posição de busca. Consulte a seção comentários para valores possíveis.

Valor de retorno

A posição do ponteiro do arquivo se o método tenha êxito; caso contrário, o valor de retorno é indefinida e um ponteiro para CFileException de uma exceção é lançada.

Comentários

A tabela a seguir lista os possíveis valores para o parâmetro de nFrom .

Valor

Descrição

CFile::begin

Pesquisa do início do arquivo.

CFile::current

Pesquisa do local atual do ponteiro do arquivo.

CFile::end

Pesquisa do final do arquivo.

Quando um arquivo é aberto, o ponteiro do arquivo está localizado em 0, o início do arquivo.

Você pode definir o ponteiro do arquivo a uma posição além de extremidade de um arquivo. Se você fizer isso, o tamanho do arquivo não aumenta até que você gravar o arquivo.

O manipulador de exceção para esse método deve excluir o objeto de exceção após a exceção é processada.

Exemplo

CFile cfile;
cfile.Open(_T("Seek_File.dat"), CFile::modeCreate |
   CFile::modeReadWrite);
LONGLONG lOffset = 1000;
ULONGLONG lActual;
lActual = cfile.Seek(lOffset, CFile::begin);

Requisitos

Cabeçalho: afx.h

Consulte também

Referência

Classe CFile

Gráfico da hierarquia