IStream::Clone

9/8/2008

Esse método cria um novo objeto de fluxo com sua própria ponteiro buscar que cita o mesmo bytes como o original transmitir.

Syntax

HRESULT Clone( 
  IStream** ppstm 
);

Parameters

• ppstm
  [out] Quando bem-sucedido, ponteiro para a localidade de um IStream ponteiro interface para o novo objeto transmitir.

  Se ocorrer um erro, esse parâmetro é NULL.

Return Value

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

Valor	Descrição
S_OK	A transmitir foi clonado com êxito.
E_PENDING	Somente armazenamento assíncrono: Parte ou todos os dados de transmitir é atualmente não disponível.
STG_E_INSUFFICIENT_MEMORY	Não foi clonado a transmitir devido a uma falta de memória.
STG_E_INVALIDPOINTER	O ppStm ponteiro 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

Esse método cria um objeto transmitir para acessar os mesmos bytes mas usando um separar ponteiro buscar.

O objeto transmitir vê os mesmos dados como o objeto transmitir origem.

Alterações gravadas para um objeto são imediatamente visíveis no outro.

Bloqueando intervalo é compartilhado entre os objetos transmitir.

A configuração inicial do ponteiro de busca na instância de transmitir clonado é o mesmo que a atual configuração do ponteiro de busca no original transmitir no tempo de operação de clone.

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