OleDuplicateData, fonction (ole2.h)

Article
02/29/2024

Dupliquez les données trouvées dans le handle spécifié et retourne un handle aux données dupliquées. Les données sources sont au format Presse-papiers. Utilisez cette fonction pour implémenter certaines des interfaces de transfert de données telles que IDataObject.

Syntaxe

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

Paramètres

[in] hSrc

Gérer les données sources.

[in] cfFormat

Format du Presse-papiers des données sources.

[in] uiFlags

Indicateurs à utiliser pour allouer de la mémoire globale pour les données copiées. Ces indicateurs sont passés à GlobalAlloc. Si la valeur de uiFlags est NULL, GMEM_MOVEABLE est utilisé comme indicateur par défaut.

Valeur retournée

En cas de réussite, le HANDLE dans les données sources est retourné ; en cas d’échec, une valeur NULL est retournée.

Remarques

Les formats CF_METAFILEPICT, CF_PALETTE ou CF_BITMAP reçoivent une gestion spéciale. Il s’agit de handles GDI et un nouvel objet GDI doit être créé au lieu de simplement copier les octets. Tous les autres formats sont dupliqués en octets.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Partager via