Compartilhar via


COleDataSource::OnSetData

Chamado pela estrutura para definir ou substituir os dados no objeto de COleDataSource no formato especificado.

virtual BOOL OnSetData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium,
   BOOL bRelease 
);

Parâmetros

  • lpFormatEtc
    Pontos a estrutura de FORMATETC que especifica o formato em que os dados estão sendo substituídos.

  • lpStgMedium
    Os pontos a estrutura de STGMEDIUM que contém os dados que irão substituir o conteúdo atual de COleDataSource objeto.

  • bRelease
    Indica que a propriedade tem suporte de memória após ter concluído a chamada de função.O chamador decidir o que é responsável para liberar os recursos alocados no meio de armazenamento.O chamador isso defina bRelease.Se bRelease é diferente de zero, a fonte de dados usa a propriedade, liberando o meio quando tiver terminado de usar.Quando bRelease é 0, o chamador mantém a propriedade e a fonte de dados pode usar o suporte de memória somente para a duração de chamada.

Valor de retorno

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

Comentários

A fonte de dados não leva a propriedade de dados até que a obtenha com êxito.Isto é, não executa a ação se retorna 0 de OnSetData .Se a fonte de dados usa a propriedade, libera suporte de memória chamar a função de ReleaseStgMedium .

A implementação padrão não fará nada.Substituir essa função para substituir os dados no formato especificado.Este é um substituível avançado.

Para obter mais informações, consulte as estruturas de STGMEDIUM e de FORMATETC e funções de ReleaseStgMedium e de IDataObject::GetData em Windows SDK*.*

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe de COleDataSource

Gráfico de hierarquia

COleDataSource::DelaySetData

COleDataSource::OnRenderData

COleDataSource::OnRenderFileData

COleDataSource::OnRenderGlobalData

COleServerItem::OnSetData