Método IStream::Seek (objidl.h)

O método Seek altera o ponteiro seek para um novo local. O novo local é relativo ao início do fluxo, ao final do fluxo ou ao ponteiro de busca atual.

Sintaxe

HRESULT Seek(
  [in]  LARGE_INTEGER  dlibMove,
  [in]  DWORD          dwOrigin,
  [out] ULARGE_INTEGER *plibNewPosition
);

Parâmetros

[in] dlibMove

O deslocamento a ser adicionado ao local indicado pelo parâmetro dwOrigin . Se dwOrigin for STREAM_SEEK_SET, isso será interpretado como um valor não assinado em vez de um valor assinado.

[in] dwOrigin

A origem do deslocamento especificado em dlibMove. A origem pode ser o início do arquivo (STREAM_SEEK_SET), o ponteiro de busca atual (STREAM_SEEK_CUR) ou o final do arquivo (STREAM_SEEK_END). Para obter mais informações sobre valores, consulte a enumeração STREAM_SEEK .

[out] plibNewPosition

Um ponteiro para o local em que esse método grava o valor do novo ponteiro de busca desde o início do fluxo.

Você pode definir esse ponteiro como NULL. Nesse caso, esse método não fornece o novo ponteiro de busca.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

IStream::Seek altera o ponteiro seek para que as operações de leitura e gravação subsequentes possam ser executadas em um local diferente no objeto de fluxo. É um erro buscar antes do início do fluxo. No entanto, não é um erro buscar além do final do fluxo. Buscar além do final do fluxo é útil para operações de gravação subsequentes, pois o intervalo de bytes de fluxo será estendido para a nova posição de busca imediatamente antes que a gravação seja concluída.

Você também pode usar esse método para obter o valor atual do ponteiro seek chamando esse método com o parâmetro dwOrigin definido como STREAM_SEEK_CUR e o parâmetro dlibMove definido como 0 para que o ponteiro seek não seja alterado. O ponteiro de busca atual é retornado no parâmetro plibNewPosition .

Requisitos

Confira também

ISequentialStream::Read

ISequentialStream::Write

IStream – Implementação de arquivo composto

STREAM_SEEK