COleDataSource::OnRenderData

Artigo
02/25/2013

Chamado pela estrutura para recuperar dados no formato especificado.

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

Parâmetros

lpFormatEtc
Pontos a estrutura de FORMATETC que especifica o formato em que a informação é solicitada.
lpStgMedium
Pontos a estrutura de STGMEDIUM em que os dados serão retornado.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

O formato especificado é colocado anteriormente em um objeto de COleDataSource usando a função de membro de DelayRenderData ou de DelayRenderFileData para processar tarde.A implementação padrão de essa função chamada OnRenderFileData ou OnRenderGlobalData se o suporte de memória fornecido é um arquivo ou memória, respectivamente.Se nenhum de esses formatos são fornecidos, então a implementação padrão retornará 0 e não fará nada.Para obter mais informações sobre o processamento de tarde como tratado pelo MFC, consulte o artigo objetos de dados e fontes de dados: Tratamento.

Se lpStgMedium->tymed é TYMED_NULL, STGMEDIUM deve ser atribuído e preenchido como especificado pelo lpFormatEtc->tymed.Se não é TYMED_NULL, STGMEDIUM deve ser preenchido com dados no lugar.

Este é um substituível avançado.Substituir essa função para fornecer os dados no formato e entre aplicativos.Dependendo dos dados, você pode querer substituir o invés de uma das outras versões de essa função.Se os dados são pequenos e corrigidos em tamanho, substitua OnRenderGlobalData.Se seus dados estão em um arquivo, ou são de tamanho variável, substitua OnRenderFileData.

Para obter mais informações, consulte as estruturas de STGMEDIUM e de FORMATETC , o tipo de enumeração de TYMED , e IDataObject::GetData em Windows SDK*.*