IStream::Seek

9/8/2008

Este método altera o ponteiro de busca para um nova localidade relativo para o atual busca ponteiro ou o início ou final da transmitir.

Syntax

HRESULT Seek( 
  ULARGE_INTEGER dlibMove, 
  DWORD dwOrigin, 
  ULARGE_INTEGER plibNewPosition 
);

Parameters

• dlibMove
  [no] Deslocamento a ser adicionado à localidade indicada pelo dwOrigin parâmetro. Se dwOrigin é STREAM_SEEK_SET, isso é interpretado como uma sem assinatura valor em vez de assinado.

• dwOrigin
  [no] Origem para o deslocamento especificado em dlibMove. A origem pode ser início do arquivo, a atual buscar ponteiro ou o final do arquivo.

• plibNewPosition
  [out] Ponteiro para a localidade onde este método grava o valor do novo ponteiro buscar a partir do início da transmitir.

  Você pode definir este ponteiro como NULL para indicar que você não está interessados nesse valor. Neste maiúsculas e minúsculas, este método não oferece o novo ponteiro buscar.

Return Value

A seguinte tabela mostra os valores de retorno para este método.

Valor	Descrição
S_OK	O ponteiro de busca foi ajustado com êxito.
E_PENDING	Somente armazenamento assíncrono: Parte ou todos os dados de transmitir é atualmente não disponível.
STG_E_INVALIDPOINTER	O valor da plibNewPosition parâmetro não é válido.
STG_E_INVALIDFUNCTION	O valor da dwOrigin parâmetro não é válido.
STG_E_REVERTED	O objeto tenha sido invalidado por uma operação de reversão acima na árvore de transação.

Remarks

IStream::Seek Altera o ponteiro de busca de forma que subseqüentes leituras e gravações podem levar local em uma localidade diferente no objeto de transmitir.

É um erro ao buscar antes do início do transmitir.

Não é, no entanto, um erro ao buscar após o final da transmitir. Procurando após o final da transmitir é útil para gravações subseqüentes, conforme a transmitir desse tempo será estendido para a posição buscar imediatamente antes da a gravação é feita.

Você também pode usar esse método para obter o atual valor do ponteiro a busca por chamado esse método com o dwOrigin parâmetro definido como STREAM_SEEK_CUR e o dlibMove parâmetro definido como zero para que o ponteiro buscar não é alterado.

O atual buscar ponteiro é retornado na plibNewPosition parâmetro.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later