다음을 통해 공유

OleQueryCreateFromData 함수(ole2.h)

  • 아티클

데이터 개체에 OleCreateFromData 또는 OleCreateStaticFromData 함수를 호출하여 포함된 개체가 될 수 있는 형식 중 하나가 있는지 확인합니다.

구문

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

매개 변수

[in] pSrcDataObject

쿼리할 데이터 전송 개체의 IDataObject 인터페이스에 대한 포인터입니다.

반환 값

이 함수는 성공에 대한 S_OK 반환합니다. 다른 가능한 값은 다음과 같습니다.

반환 코드 설명
S_FALSE
 포함된 개체 또는 정적 개체 만들기를 지원하는 형식이 없습니다.
OLE_S_STATIC
 정적 개체 만들기를 지원하는 형식이 있습니다.

설명

애플리케이션이 OleGetClipboard 함수 호출을 통해 데이터 전송 개체를 검색하는 경우 애플리케이션은 편집/붙여넣기 또는 편집/붙여넣기 특수... 명령을 사용하거나 사용하지 않도록 결정하는 프로세스의 일부로 OleQueryCreateFromData를 호출해야 합니다. 데이터 개체에 다음 형식이 있는지 테스트합니다.

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
데이터 개체에 이러한 형식 중 하나가 있다고 해서 개체 만들기가 성공한다고 보장할 수는 없지만 프로세스에 도움이 됩니다.

OleQueryCreateFromData가 CF_METAFILEPICT, CF_BITMAP, CF_DIB 또는 CF_ENHMETAFILE 형식 중 하나를 찾은 경우 OLE_S_STATIC 반환하며, 포함된 개체를 만들려면 OleCreateStaticFromData 함수를 호출해야 함을 나타냅니다.

OleQueryCreateFromData가 정적 형식과 함께 다른 형식(CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE 또는 cfFileName) 중 하나를 찾으면 포함된 개체를 만들려면 OleCreateFromData 함수를 호출해야 함을 나타내는 S_OK 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ole2.h
라이브러리 Ole32.lib
DLL Ole32.dll
API 세트 ext-ms-win-com-ole32-l1-1-3(Windows 10 버전 10.0.10240에 도입됨)

추가 정보

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData