Função OleDuplicateData (ole2.h)

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