Funzione OleDuplicateData (ole2.h)

Duplica i dati trovati nell'handle specificato e restituisce un handle ai dati duplicati. I dati di origine sono in formato Appunti. Usare questa funzione per implementare alcune interfacce di trasferimento dati, ad esempio IDataObject.

Sintassi

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

Parametri

[in] hSrc

Gestione dei dati di origine.

[in] cfFormat

Formato appunti dei dati di origine.

[in] uiFlags

Flag da usare per allocare memoria globale per i dati copiati. Questi flag vengono passati a GlobalAlloc. Se il valore di uiFlags è NULL, GMEM_MOVEABLE viene usato come flag predefinito.

Valore restituito

In caso di esito positivo, viene restituito l'handle ai dati di origine; in caso di errore viene restituito un valore NULL .

Commenti

I formati CF_METAFILEPICT, CF_PALETTE o CF_BITMAP ricevono una gestione speciale. Sono handle GDI e deve essere creato un nuovo oggetto GDI anziché copiare i byte. Tutti gli altri formati sono duplicati byte-wise.

Requisiti