Share via


COleDataObject::GetFileData

Llame a esta función para crear CFile o CFile- objeto derivado y recuperar datos en el formato especificado en un puntero de CFile .

CFile* GetFileData(
   CLIPFORMAT cfFormat,
   LPFORMATETC lpFormatEtc = NULL 
);

Parámetros

  • cfFormat
    El formato en el que los datos debe volver.Este parámetro puede tener uno de los formatos de Portapapeles predefinidos o el valor devuelto por la función de Windows RegisterClipboardFormat nativo.

  • lpFormatEtc
    Señala una estructura de FORMATETC que describe el formato en el que los datos debe volver.Proporcione un valor para este parámetro si desea especificar la información de formato adicional más allá del formato del Portapapeles especificado por cfFormat.Si es NULL, los valores predeterminados que se utilizan para los demás campos en la estructura de FORMATETC .

Valor devuelto

Puntero al nuevo CFile o a CFile- objeto derivado que contiene los datos si correctamente; si no NULL.

Comentarios

Dependiendo del medio que los datos se almacenan en, el tipo real designado por el valor devuelto puede ser CFile, CSharedFile, o COleStreamFile.

[!NOTA]

El objeto de CFile acceso al valor devuelto de esta función es propiedad del llamador.Es responsabilidad del llamador para cancelación el objeto de CFile , de esta manera cerrando el archivo.

Para obtener más información, vea FORMATETC en Windows SDK.

Para obtener más información, vea RegisterClipboardFormat en Windows SDK.

Requisitos

encabezado: afxole.h

Vea también

Referencia

Clase de COleDataObject

Gráfico de jerarquía

COleDataObject::GetData

COleDataObject::GetGlobalData

COleDataObject::IsDataAvailable