Partilhar 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 classe derivada COleServerItem

Gráfico da hierarquia

COleDataSource::OnSetData