OleDuplicateData-Funktion (ole2.h)

Dupliziert die im angegebenen Handle gefundenen Daten und gibt ein Handle an die duplizierten Daten zurück. Die Quelldaten befinden sich in einem Zwischenablageformat. Verwenden Sie diese Funktion, um einige der Datenübertragungsschnittstellen wie IDataObject zu implementieren.

Syntax

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

Parameter

[in] hSrc

Handle der Quelldaten.

[in] cfFormat

Zwischenablageformat der Quelldaten.

[in] uiFlags

Flags, die zum Zuweisen des globalen Arbeitsspeichers für die kopierten Daten verwendet werden sollen. Diese Flags werden an GlobalAlloc übergeben. Wenn der Wert von uiFlagsNULL ist, wird GMEM_MOVEABLE als Standardflag verwendet.

Rückgabewert

Bei Erfolg wird das HANDLE für die Quelldaten zurückgegeben. bei Einem Fehler wird ein NULL-Wert zurückgegeben.

Hinweise

Die formate CF_METAFILEPICT, CF_PALETTE oder CF_BITMAP werden speziell behandelt. Es handelt sich um GDI-Handles, und ein neues GDI-Objekt muss erstellt werden, anstatt nur die Bytes zu kopieren. Alle anderen Formate sind byteweise dupliziert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ole2.h
Bibliothek	Ole32.lib
DLL	Ole32.dll