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