Compartilhar via


COleServerItem::OnSetData

Chamado pela estrutura para substituir os dados VELHOS de item com os dados especificados.

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

Parâmetros

  • lpFormatEtc
    Ponteiro a estrutura de FORMATETC que especifica o formato de dados.

  • lpStgMedium
    Ponteiro a estrutura de STGMEDIUM em que os dados residem.

  • 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, o item do servidor recebe a propriedade, liberando o meio quando tiver terminado de usar.Quando bRelease é 0, o chamador mantém a propriedade e o item de servidor 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

O item do servidor não leva a propriedade de dados até que a obtenha com êxito.Isto é, não executa se a propriedade retorna 0.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 VELHOS de item com os dados especificados.Este é um substituível avançado.

Para obter mais informações, consulte STGMEDIUM, FORMATETC, e ReleaseStgMedium em Windows SDK.

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe de COleServerItem

Gráfico de hierarquia

COleDataSource::OnSetData