Función OleCreateFromData (ole2.h)

Crea un objeto incrustado a partir de un objeto de transferencia de datos recuperado del Portapapeles o como parte de una operación de arrastrar y colocar OLE. Está pensado para usarse para implementar un pegado desde una operación de arrastrar y colocar OLE.

Sintaxis

HRESULT OleCreateFromData(
  [in]  LPDATAOBJECT    pSrcDataObj,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     pFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Parámetros

[in] pSrcDataObj

Puntero a la interfaz IDataObject del objeto de transferencia de datos que contiene los datos desde los que se crea el objeto.

[in] riid

Referencia al identificador de la interfaz que el autor de la llamada usa más adelante para comunicarse con el nuevo objeto (normalmente IID_IOleObject, definido en los encabezados OLE como identificador de interfaz para IOleObject).

[in] renderopt

Valor de la enumeración OLERENDER que indica las funcionalidades de dibujo o recuperación de datos almacenadas localmente en caché que debe tener el objeto recién creado. Las consideraciones adicionales se describen en la sección Comentarios siguiente.

[in] pFormatEtc

Puntero a un valor de la enumeración OLERENDER que indica las capacidades de dibujo o recuperación de datos almacenadas localmente en caché que debe tener el objeto recién creado. El valor OLERENDER elegido afecta a los valores posibles para el parámetro pFormatEtc .

[in] pClientSite

Puntero a una instancia de IOleClientSite, la interfaz principal a través de la cual el objeto solicitará servicios de su contenedor. Este parámetro puede ser NULL.

[in] pStg

Puntero a la interfaz IStorage en el objeto de almacenamiento. Este parámetro puede no ser NULL.

[out] ppvObj

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvObj contiene el puntero de interfaz solicitado en el objeto recién creado.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Comentarios

La función OleCreateFromData crea un objeto incrustado a partir de un objeto de transferencia de datos que admite la interfaz IDataObject . En este caso, el objeto de datos es el tipo recuperado del Portapapeles con una llamada a la función OleGetClipboard o forma parte de una operación ole de arrastrar y colocar (el objeto de datos se pasa a una llamada a IDropTarget::D rop).

Si el formato del Portapapeles FileName o FileNameW (CF_FILENAME) está presente en el objeto de transferencia de datos y CF_EMBEDDEDOBJECT o CF_EMBEDSOURCE no existen, OleCreateFromData intenta crear primero un paquete que contenga el archivo indicado. Por lo general, toma el primer formato disponible.

Si OleCreateFromData no puede crear un paquete, intenta crear un objeto con el formato CF_EMBEDDEDOBJECT. Si ese formato no está disponible, OleCreateFromData intenta crearlo con el formato CF_EMBEDSOURCE. Si ninguno de estos formatos está disponible y el objeto de transferencia de datos admite la interfaz IPersistStorage , OleCreateFromData llama al objeto IPersistStorage::Save para que el objeto se guarde.

Si se selecciona un objeto vinculado existente, después se copia, aparece en el Portapapeles como otro objeto incrustable. Por consiguiente, una operación de pegado que invoca OleCreateFromData puede crear un objeto vinculado. Después de la operación de pegado, el contenedor debe llamar a la función QueryInterface , solicitando IID_IOleLink (definido en los encabezados OLE como identificador de interfaz para IOleLink), para determinar si se creó un objeto vinculado.

Use los parámetros renderopt y pFormatetc para controlar la funcionalidad de almacenamiento en caché del objeto recién creado. Para obtener información general sobre el uso de la interacción de estos parámetros para determinar qué se va a almacenar en caché, consulte la enumeración OLERENDER . Sin embargo, hay algunos efectos específicos adicionales de estos parámetros en la forma en que OleCreateFromData inicializa la memoria caché.

Cuando OleCreateFromData usa el CF_EMBEDDEDOBJECT o el formato del Portapapeles de CF_EMBEDSOURCE para crear el objeto incrustado, la principal diferencia entre los dos es donde se almacenan los datos de inicialización de caché:

• CF_EMBEDDEDOBJECT indica que el origen es un objeto incrustado existente. Ya tiene en su memoria caché los datos adecuados y OLE usa estos datos para inicializar la memoria caché del nuevo objeto.
• CF_EMBEDSOURCE indica que el objeto de datos de origen contiene la información de inicialización de caché en formatos distintos de CF_EMBEDSOURCE. OleCreateFromData los usa para inicializar la memoria caché del objeto recién incrustado.

Requisitos

Consulte también

IDataObject

OleCreate