virtual BOOL OnSetData ( LPFORMATETC lpFormatEtc, LPSTGMEDIUM lpStgMedium, BOOL bRelease );
Valor de retorno
Diferente de zero se bem-sucedida; caso contrário 0.
Parâmetros
lpFormatEtc
Aponta para o FORMATETC estrutura especificando o formato no qual os dados está sendo substituídos.
lpStgMedium
Aponta para o STGMEDIUM estrutura contendo os dados que irão substituir o conteúdo atual do objeto COleDataSource.
bRelease
Indica quem tem apropriar o médio de armazenamento após concluir a chamada de função. O chamador decide quem é o responsável por liberar os recursos alocados on behalf of a médio de armazenamento. O chamador faz isso por configuração bRelease. Se bRelease for diferente de zero, a fonte de dados se apropria, liberar a mídia quando ele tiver terminado de usá-lo. Quando bRelease for 0, o chamador retém apropriar e a fonte de dados pode usar a mídia de armazenamento somente para a duração da chamada.
Observações
Chamado pela estrutura para definir ou substituir os dados no objeto COleDataSource no Formatarar especificado. A fonte de dados não apropriar os dados até que ele obteve com êxito-lo. Ou seja, ele não apropriar se OnSetData retorna 0. Se apropria-se da fonte de dados, ele libera o meio de armazenamento, chamando a ReleaseStgMedium função.
A implementação padrão não faz nada. Substituir esta função para substituir os dados no Formatarar especificado. Este é um avançado substituível.
Para obter mais informações, consulte o STGMEDIUM e estruturas FORMATETC e o ReleaseStgMedium e IDataObject:: GetData funções no referência OLE 2 Programmer, Volume 1.
Visão geral de COleDataSource | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;COleDataSource::DelaySetData, COleDataSource::OnRenderData, COleDataSource::OnRenderFileData, COleDataSource::OnRenderGlobalData, COleServerItem::OnSetData