OleCreateLink 함수(ole2.h)

OLE 복합 문서 연결된 개체를 만듭니다.

구문

HRESULT OleCreateLink(
  [in]  LPMONIKER       pmkLinkSrc,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

매개 변수

[in] pmkLinkSrc

연결된 개체의 원본을 찾는 데 사용할 수 있는 모니커의 IMoniker 인터페이스에 대한 포인터입니다.

[in] riid

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

[in] renderopt

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

[in] lpFormatEtc

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

[in] pClientSite

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

[in] pStg

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

[out] ppvObj

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

반환 값

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

반환 코드	설명
OLE_E_CANT_BINDTOSOURCE	원본에 바인딩할 수 없습니다.

설명

OleCreateLink를 호출하여 컨테이너가 개체에 대한 링크를 만들 수 있도록 합니다.

요구 사항

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

추가 정보

IOleClientSite::GetMoniker

IOleObject::SetMoniker