Compartilhar via


COleDataObject::GetFileData

telefonar Esta função para criar um CFile ou CFile-derivados do objeto e para recuperar dados no formato especificado em um CFile ponteiro.

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

Parâmetros

  • cfFormat
    O formato em que os dados são a ser retornado.Esse parâmetro pode ser um dos formatos predefinidos de área de transferência ou o valor retornado pelo Windows nativo RegisterClipboardFormat função.

  • lpFormatEtc
    Aponta para um FORMATETC estrutura que descreve o formato em que os dados são a ser retornado.Fornecer um valor para esse parâmetro se desejar especificar as informações de formato adicionais além o formato da área de transferência especificado por cfFormat. Se for NULO, os valores padrão são usados para outros campos no FORMATETC estrutura.

Valor de retorno

Ponteiro para o novo CFile ou CFile-objeto derivado que contém os dados se bem-sucedida; caso contrário NULO.

Comentários

Dependendo de meio porte que os dados são armazenados no tipo real apontado pelo valor retornado pode ser CFile, CSharedFile, ou COleStreamFile.

Observação:

O CFile objeto acessado pelo valor retornado dessa função é pertence ao chamador. É responsabilidade do chamador para Excluir the CFile objeto, assim, fechando o arquivo.

Para obter mais informações, consulte FORMATETC in the Windows SDK.

Para obter mais informações, consulte RegisterClipboardFormat in the Windows SDK.

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe COleDataObject

Gráfico de hierarquia

COleDataObject::GetData

COleDataObject::GetGlobalData

COleDataObject::IsDataAvailable

Outros recursos

COleDataObject membros