COleDataSource::OnRenderGlobalData

Artigo
08/25/2010

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 um ainda não foi alocado, 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 sobre renderização atrasado sistema autônomo manipulado pelo MFC, consulte o artigo Objetos de dados e fontes de dados: Manipulação de.

Para obter mais informações, consulte o FORMATETC estrutura de e IDataObject::GetData in the Windows SDK*.*