OleCreateLinkToFile 함수(ole2.h)

파일에 연결된 개체를 만듭니다.

구문

HRESULT OleCreateLinkToFile(
  [in]  LPCOLESTR       lpszFileName,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

매개 변수

[in] lpszFileName

연결할 원본 파일의 이름을 지정하는 문자열에 대한 포인터입니다.

[in] riid

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

[in] renderopt

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

[in] lpFormatEtc

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

[in] pClientSite

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

[in] pStg

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

[out] ppvObj

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

반환 값

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

반환 코드	설명
STG_E_FILENOTFOUND	파일 이름이 잘못되었습니다.
OLE_E_CANT_BINDTOSOURCE	원본에 바인딩할 수 없습니다.

설명

OleCreateLinkToFile 함수는 OLE를 인식하지 못하는 파일과 Windows Packager를 사용하는 파일에 대한 링크를 만들 수 있으므로 OleCreateLink 함수와 다릅니다.

요구 사항

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

추가 정보

OleCreateLink