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

El método Clone crea un nuevo objeto de secuencia con su propio puntero de búsqueda que hace referencia a los mismos bytes que la secuencia original.

Sintaxis

HRESULT Clone(
  [out] IStream **ppstm
);

Parámetros

[out] ppstm

Cuando se ejecuta correctamente, puntero a la ubicación de un puntero IStream al nuevo objeto de secuencia. Si se produce un error, este parámetro es NULL.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La secuencia se clonó correctamente.
E_PENDING	Solo almacenamiento asincrónico: la parte o todos los datos de la secuencia no están disponibles actualmente.
STG_E_INSUFFICIENTMEMORY	La secuencia no se clonó debido a una falta de memoria.
STG_E_INVALIDPOINTER	El puntero ppStm no es válido.
STG_E_REVERTED	El objeto se ha invalidado por una operación de reversión por encima de él en el árbol de transacciones.

Comentarios

El método Clone crea un nuevo objeto de secuencia para tener acceso a los mismos bytes, pero mediante un puntero de búsqueda independiente. El nuevo objeto de secuencia ve los mismos datos que el objeto de flujo de origen. Los cambios escritos en un objeto son visibles inmediatamente en el otro. El bloqueo de intervalo se comparte entre los objetos de secuencia.

La configuración inicial del puntero de búsqueda en la instancia de secuencia clonada es la misma que la configuración actual del puntero de búsqueda en la secuencia original en el momento de la operación de clonación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objidl.h
Library	Uuid.lib
Archivo DLL	Ole32.dll

Consulte también

IStream: implementación de archivos compuestos

IStream::CopyTo