COleDataSource::OnSetData

Artigo
08/25/2010

Chamada pela estrutura para conjunto ou substituir os dados no COleDataSource objeto no formato especificado.

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

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 que contém os dados que substituirá o Sumário corrente do COleDataSource objeto.
bRelease
Indica quem tem a propriedade da meio de armazenamento depois de concluir a telefonar de função.O chamador decide quem é responsável por liberando os recursos alocados em nome de meio de armazenamento.O chamador faz isso através da configuração bRelease. If bRelease é diferente de zero, a fonte de dados se apropria, liberando a meio quando ele tiver terminado de usá-lo. Quando bRelease é 0, o chamador mantém a propriedade e a fonte de dados pode usar a meio de armazenamento apenas para a duração da telefonar.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

A fonte de dados não tem propriedade dos dados até que ele possui com êxito obtido.Ou seja, ele não as propriedade se OnSetData Retorna 0. Se a fonte de dados apropriar-se, ele libera a meio de armazenamento, chamando o ReleaseStgMedium função.

A implementação padrão não faz nada.Substitua esta função para substituir os dados no formato especificado.Esta é uma avançada substituível.

Para obter mais informações, consulte o STGMEDIUM and FORMATETC o e estruturasReleaseStgMedium and IDataObject::GetData funções o Windows SDK*.*