Método IByteBuffer::Clone

[El método Clone está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. No está disponible para su uso en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores, Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La interfaz IStream proporciona una funcionalidad similar.]

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

Sintaxis

HRESULT Clone(
  [out] LPBYTEBUFFER *ppByteBuffer
);

Parámetros

ppByteBuffer [out]

Cuando se ejecuta correctamente, apunta a la ubicación de un puntero IByteBuffer al nuevo objeto de secuencia. Cuando haya terminado de usar el puntero IByteBuffer, suelte mediante una llamada a la función IUnknown::Release . Si se produce un error, este parámetro es NULL.

Valor devuelto

El valor devuelto es un HRESULT. Un valor de S_OK indica que la llamada se realizó correctamente.

Comentarios

Este método crea un nuevo objeto de secuencia para tener acceso a los mismos bytes, pero con 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 están visibles inmediatamente en el otro. El bloqueo de intervalo se comparte entre los objetos de secuencia.

El valor inicial del puntero de búsqueda en la instancia de secuencia clonada es el mismo que el valor actual del puntero de búsqueda en la secuencia original en el momento de la operación de clonación.

Ejemplos

En el ejemplo siguiente se muestra la clonación de la interfaz IByteBuffer .

HRESULT  hr;

// Clone the buffer.
hr = pIByteBuff->Clone(&pIByteClone);
if (FAILED(hr))
  printf("Failed IByteBuffer::Clone\n");

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Fin de compatibilidad de cliente	Windows XP
Fin de compatibilidad de servidor	Windows Server 2003
Encabezado	Scardssp.h
Biblioteca de tipos	Scardssp.tlb
Archivo DLL	Scardssp.dll
IID	IID_IByteBuffer se define como E126F8FE-A7AF-11D0-B88A-00C04FD424B9