Partilhar via


CInternetFile::Seek

Chamar essa função de membro para reposicionar o ponteiro em um arquivo aberto anteriormente.

virtual ULONGLONG Seek( 
   LONGLONG lOffset, 
   UINT nFrom  
);

Parâmetros

  • lOffset
    Desloca em bytes para mover o ponteiro de leitura/gravação no arquivo.

  • nFrom
    Referência para o deslocamento relativo. Deve ser um dos seguintes valores:

    • Mudança deCFile::begin os bytes de lOff do ponteiro do arquivo dianteiros do início do arquivo.

    • Mudança deCFile::current os bytes de lOff do ponteiro do arquivo da posição atual no arquivo.

    • Mudança deCFile::end os bytes de lOff do ponteiro do arquivo do final do arquivo. lOff deve ser negativo buscar no arquivo; existente os valores positivos buscarão após o final do arquivo.

Valor de retorno

O novo deslocamento de bytes do início do arquivo se a posição solicitada é válido; caso contrário, o valor é indefinida e um objeto de CInternetException é lançada.

Comentários

A função de Seek permite de acesso aleatório aos conteúdo de um arquivo movendo o ponteiro um determinar a quantidade especificada, ou relativamente. Nenhum dado é realmente lida durante a busca.

Em o momento, uma chamada à essa função de membro é suportado apenas para os dados associados aos objetos de CHttpFile . Não há suporte para FTP ou solicitações de Gopher. Se você chamar Seek para um de esses serviços sem suporte, você irá passar a volta para o código de erro ERROR_INTERNET_INVALID_OPERATIONWin32.

Quando um arquivo é aberto, o ponteiro do arquivo é deslocado 0, o início do arquivo.

Dica

Usar Seek pode causar uma chamada implícita a Liberação.

Exceções

Esse método pode lançar exceções do tipo CInternetException*.

Exemplo

Consulte o exemplo para a implementação da classe base (CFile::Seek).

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

Classe CInternetFile

Gráfico da hierarquia