Compartilhar via


COleServerItem::OnRenderGlobalData

Chamado pela estrutura para recuperar dados no formato especificado quando a meio de armazenamento especificado é a memória global.

virtual BOOL OnRenderGlobalData(
   LPFORMATETC lpFormatEtc,
   HGLOBAL* phGlobal 
);

Parâmetros

  • lpFormatEtc
    Aponta para o FORMATETC estrutura especificando o formato no qual as informações são solicitadas.

  • phGlobal
    Aponta para um identificador de memória global em que os dados estão a ser retornado.Se nenhuma memória foi alocada, esse parâmetro pode ser NULO.

Valor de retorno

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

Comentários

O formato especificado é um previamente colocado no COleDataSource objeto usando o DelayRenderDatafunção de membro para renderização posterior.A implementação padrão dessa função simplesmente retorna FALSE.

If phGlobal é NULOe, em seguida, um novo HGLOBAL deve ser alocada e retornados em phGlobal. Caso contrário, a HGLOBAL especificado pelo phGlobal deve ser preenchido com os dados. A quantidade de dados colocada no HGLOBAL não deve exceder o dimensionar corrente do bloco de memória. Além disso, o bloco não pode ser realocado para um dimensionar maior.

Esta é uma avançada substituível.Substitua esta função para fornecer seus dados no formato solicitado e meio.Dependendo de seus dados, é aconselhável substituir uma das outras versões dessa função em vez disso.Se você deseja manipular várias mídias de armazenamento, substituir OnRenderData.Se seus dados em um arquivo ou é de dimensionar variável, substituir OnRenderFileData.

Para obter mais informações, consulte IDataObject::GetData and FORMATETC in the Windows SDK.

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe COleServerItem

Gráfico de hierarquia

COleServerItem::OnRenderData

Outros recursos

COleServerItem membros