OleDuplicateData 함수(ole2.h)

지정된 핸들에 있는 데이터를 복제하고 중복된 데이터에 대한 핸들을 반환합니다. 원본 데이터는 클립보드 형식입니다. 이 함수를 사용하여 IDataObject와 같은 일부 데이터 전송 인터페이스를 구현할 수 있습니다.

구문

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

매개 변수

[in] hSrc

원본 데이터의 핸들입니다.

[in] cfFormat

원본 데이터의 클립보드 형식입니다.

[in] uiFlags

복사된 데이터에 대한 전역 메모리를 할당하는 데 사용할 플래그입니다. 이러한 플래그는 GlobalAlloc에 전달됩니다. uiFlags 값이 NULL이면 GMEM_MOVEABLE 기본 플래그로 사용됩니다.

반환 값

성공하면 원본 데이터에 대한 HANDLE이 반환됩니다. 실패 시 NULL 값이 반환됩니다.

설명

CF_METAFILEPICT, CF_PALETTE 또는 CF_BITMAP 형식은 특별한 처리를 받습니다. GDI 핸들이며 바이트를 복사하는 대신 새 GDI 개체를 만들어야 합니다. 다른 모든 형식은 바이트 단위로 복제됩니다.

요구 사항