Método IOleObject::GetClipboardData (oleidl.h)

Artículo
08/25/2023

Recupera un objeto de datos que contiene el contenido actual del objeto incrustado en el que se llama a este método. Con el puntero a este objeto de datos, es posible crear un nuevo objeto incrustado con los mismos datos que el original.

Sintaxis

HRESULT GetClipboardData(
  [in]  DWORD       dwReserved,
  [out] IDataObject **ppDataObject
);

Parámetros

[in] dwReserved

Este parámetro está reservado y debe ser cero.

[out] ppDataObject

Dirección de la variable de puntero IDataObject que recibe el puntero de interfaz al objeto de datos. Si se produce un error, ppDataObject debe establecerse en NULL. Cada vez que un objeto recibe una llamada a IOleObject::GetClipboardData, debe aumentar el recuento de referencias en ppDataObject. Es responsabilidad del autor de la llamada llamar a Release cuando se realiza con ppDataObject.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_NOTIMPL	No se admite GetClipboardData.
OLE_E_NOTRUNNING	El objeto no se está ejecutando.

Comentarios

Puede usar el método IOleObject::GetClipboardData para convertir un objeto vinculado en un objeto incrustado, en cuyo caso la aplicación contenedora llamaría a IOleObject::GetClipboardData y, a continuación, pasar los datos recibidos a OleCreateFromData. Este método devuelve un puntero a un objeto de datos idéntico al que se habría pasado al Portapapeles mediante una operación de copia estándar.

Notas a los autores de llamadas

Si desea una instantánea estable del contenido actual de un objeto incrustado, llame a IOleObject::GetClipboardData. Si cambian los datos, deberá volver a llamar a la función para obtener una instantánea actualizada. Si desea que se informe al autor de la llamada de los cambios que se producen en los datos, llame a QueryInterface y, a continuación, llame a IDataObject::D Advise.

Notas para los implementadores

Si implementa esta función, debe devolver un puntero IDataObject para un objeto cuyos datos no cambiarán.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleidl.h