Compartilhar via

Função OleDuplicateData (ole2.h)

  • Artigo

Duplica os dados encontrados no identificador especificado e retorna um identificador para os dados duplicados. Os dados de origem estão em um formato de área de transferência. Use essa função para ajudar a implementar algumas das interfaces de transferência de dados, como IDataObject.

Sintaxe

HANDLE OleDuplicateData(
  [in] HANDLE     hSrc,
  [in] CLIPFORMAT cfFormat,
  [in] UINT       uiFlags
);

Parâmetros

[in] hSrc

Identificador dos dados de origem.

[in] cfFormat

Formato da área de transferência dos dados de origem.

[in] uiFlags

Sinalizadores a serem usados para alocar memória global para os dados copiados. Esses sinalizadores são passados para GlobalAlloc. Se o valor de uiFlags for NULL, GMEM_MOVEABLE será usado como um sinalizador padrão.

Retornar valor

Em caso de êxito, o HANDLE para os dados de origem é retornado; em caso de falha, um valor NULL é retornado.

Comentários

Os formatos CF_METAFILEPICT, CF_PALETTE ou CF_BITMAP recebem tratamento especial. Eles são identificadores GDI e um novo objeto GDI deve ser criado em vez de apenas copiar os bytes. Todos os outros formatos são duplicados em bytes.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll