OleCreateLinkFromData 함수(ole2.h)

클립보드 또는 OLE 끌어서 놓기 작업의 일부로 검색된 데이터 전송 개체에서 연결된 개체를 만듭니다.

구문

HRESULT OleCreateLinkFromData(
  [in]  LPDATAOBJECT    pSrcDataObj,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     pFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

매개 변수

[in] pSrcDataObj

연결된 개체를 만들 데이터 전송 개체의 IDataObject 인터페이스에 대한 포인터입니다.

[in] riid

호출자가 나중에 새 개체와 통신하는 데 사용하는 인터페이스의 식별자에 대한 참조입니다(일반적으로 IOleObject의 인터페이스 식별자로 OLE 헤더에 정의된 IID_IOleObject).

[in] renderopt

새로 만든 개체에 로컬로 캐시된 드로잉 또는 데이터 검색 기능을 나타내는 열거형 OLERENDER 의 값입니다. 추가 고려 사항은 다음 설명 섹션에 설명되어 있습니다.

[in] pFormatEtc

새로 만든 개체에 로컬로 캐시된 그리기 또는 데이터 검색 기능을 나타내는 열거형 OLERENDER 의 값에 대한 포인터입니다. 선택한 OLERENDER 값은 pFormatEtc 매개 변수의 가능한 값에 영향을 줍니다.

[in] pClientSite

개체가 컨테이너에서 서비스를 요청하는 기본 인터페이스인 IOleClientSite의 instance 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[in] pStg

스토리지 개체의 IStorage 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다.

[out] ppvObj

riid에서 요청된 인터페이스 포인터를 수신하는 포인터 변수의 주소입니다. 성공적으로 반환되면 ppvObj 는 새로 만든 개체에 대해 요청된 인터페이스 포인터를 포함합니다.

반환 값

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

반환 코드	설명
CLIPBRD_E_CANT_OPEN	클립보드를 열 수 없습니다.
OLE_E_CANT_GETMONIKER	개체의 모니커를 추출할 수 없습니다.
OLE_E_CANT_BINDTOSOURCE	원본에 바인딩할 수 없습니다. 바인딩은 캐시의 초기화 데이터를 가져오는 데 필요합니다.

설명

OleCreateLinkFromData 함수는 붙여넣기 링크 또는 끌기 링크 작업을 구현하는 데 사용됩니다. 해당 작업은 링크를 만들고 다른 데이터 형식을 찾는다는 점을 제외하고 OleCreateFromData 함수의 작업과 유사합니다. CF_LINKSOURCE 형식이 없는 경우 FileName 또는 FileNameW 클립보드 형식이 데이터 전송 개체에 있으면 OleCreateLinkFromData 는 표시된 파일에 대한 링크가 포함된 패키지를 만듭니다.

renderopt 및 pFormatetc 매개 변수를 사용하여 새로 만든 개체의 캐싱 기능을 제어합니다. 캐시할 내용을 확인하는 방법에 대한 일반적인 내용은 renderopt와 pFormatetc 간의 상호 작용에 대한 설명은 OLERENDER 열거형을 참조하세요. 그러나 다음과 같이 OleCreateLinkFromData 가 캐시를 초기화하는 방식에 이러한 매개 변수의 몇 가지 추가적인 특정 효과가 있습니다.

값	Description
OLERENDER_DRAW, OLERENDER_FORMAT	프레젠테이션 정보가 원본 데이터 개체의 다른 형식인 경우 이 정보가 사용됩니다. 정보가 없으면 캐시는 처음에 비어 있지만 개체가 처음 실행될 때 채워집니다. 새로 만든 개체에는 다른 형식이 캐시되지 않습니다.
OLERENDER_NONE, OLERENDER_ASIS	새로 만든 개체에 캐시할 항목이 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ole2.h
라이브러리	Ole32.lib
DLL	Ole32.dll

추가 정보

OleCreateLink