OleCreateFromFileEx 함수(ole2.h)

OleCreateFromFile에서 지원하는 단일 형식 대신 여러 프레젠테이션 형식 또는 데이터를 캐싱해야 하는 컨테이너의 개체를 보다 효율적으로 인스턴스화할 수 있도록 지원하여 OleCreateFromFile 기능을 확장합니다.

구문

HRESULT OleCreateFromFileEx(
  [in]  REFCLSID        rclsid,
  [in]  LPCOLESTR       lpszFileName,
  [in]  REFIID          riid,
  [in]  DWORD           dwFlags,
  [in]  DWORD           renderopt,
  [in]  ULONG           cFormats,
  [in]  DWORD           *rgAdvf,
  [in]  LPFORMATETC     rgFormatEtc,
  [in]  IAdviseSink     *lpAdviseSink,
  [out] DWORD           *rgdwConnection,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

매개 변수

[in] rclsid

이 매개 변수는 예약되어 있으며 CLSID_NULL 합니다.

[in] lpszFileName

새 개체를 초기화해야 하는 파일의 이름에 대한 포인터입니다.

[in] riid

반환할 개체의 인터페이스 식별자에 대한 참조입니다.

[in] dwFlags

이 매개 변수는 0 또는 OLECREATE_LEAVERUNNING(0x00000001)일 수 있습니다.

[in] renderopt

OLERENDER 열거형에서 가져온 값입니다.

[in] cFormats

renderopt가 OLERENDER_FORMAT 경우 는 rgFormatEtc 배열의 FORMATETC 구조체 수를 나타내며 하나 이상이어야 합니다. 다른 모든 경우에서 이 매개 변수는 0이어야 합니다.

[in] rgAdvf

renderopt가 OLERENDER_FORMAT 경우 각각 ADVF 열거형의 값 조합인 DWORD 요소의 배열을 가리킵니다. 이 배열의 각 요소는 pAdviseSink가 NULL인지 아니면 NULL이 아닌지에 따라 IOleCache::Cache 또는 IDataObject::D Advise 호출에 대한 advf 매개 변수로 전달됩니다(아래 참조). 다른 모든 경우에서 이 매개 변수는 NULL이어야 합니다.

[in] rgFormatEtc

renderopt가 OLERENDER_FORMAT 경우 FORMATETC 구조체의 배열을 가리킵니다. pAdviseSink가 NULL이면 이 배열의 각 요소가 개체의 IOleCache::Cache 호출에 대한 pFormatEtc 매개 변수로 전달됩니다. 그러면 개체 In Process 처리기(일반적으로 기본 처리기)에서 관리하는 데이터 및 프레젠테이션 캐시를 프레젠테이션 또는 기타 캐시 가능한 데이터로 채웁니다. pAdviseSink가 NULL이 아닌 경우 이 배열의 각 요소는 iDataObject::D Advise 호출에 대한 pFormatEtc 매개 변수로 전달됩니다. 이렇게 하면 호출자(일반적으로 OLE 컨테이너)가 개체에서 받은 데이터의 자체 캐싱 또는 처리를 수행할 수 있습니다.

[in] lpAdviseSink

renderopt가 OLERENDER_FORMAT 경우 는 사용자 지정 캐싱 또는 데이터 권장 처리를 나타내는 유효한 IAdviseSink 포인터이거나 데이터 형식의 기본 캐싱을 나타내는 NULL일 수 있습니다.

[out] rgdwConnection

IDataObject::D Advise를 사용하여 각 권고 연결에 대해 pAdviseSink 인터페이스가 등록될 때 반환되는 dwConnection 값의 배열을 반환하는 위치이거나 반환된 권고 연결이 필요하지 않은 경우 NULL입니다. pAdviseSink가 NULL인 경우 이 매개 변수는 NULL이어야 합니다.

[in] pClientSite

개체가 컨테이너에서 서비스를 요청할 기본 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 경우 IOleObject::SetClientSite를 사용하여 클라이언트 사이트를 가능한 한 빨리 설정하는 것은 호출자의 책임입니다.

[in] pStg

개체에 사용할 스토리지와 개체에 대해 설정된 모든 기본 데이터 또는 프레젠테이션 캐싱에 대한 포인터입니다.

[out] ppvObj

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

반환 값

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

설명

OleCreateFromFile에 대한 다음 호출은 다음과 같습니다.

OleCreateFromFile(rclsid, lpszFileName, riid, renderopt, pFormatEtc, pClientSite, pStg, ppvObj);

는 OleCreateFromFileEx에 대한 다음 호출과 동일합니다.

DWORD    advf = ADVF_PRIMEFIRST;
    OleCreateFromFileEx(rclsid, lpszFileName, riid, renderopt, 1, &advf, pFormatEtc, NULL, pClientSite, pStg, ppvObj);

기존 인스턴스화 함수(OleCreate, OleCreateFromFile, OleCreateFromData, OleCreateLink, OleCreateLinkToFile 및 OleCreateLinkFromData)는 인스턴스화 중에 기본 캐시 위치(전달된 IStorage의 '\001OlePresXXX' 스트림 내)에 단일 프레젠테이션 또는 데이터 형식 캐시만 만듭니다. 또한 개체가 다음으로 실행 중 상태가 될 때 이러한 캐시를 만들어야 합니다. 대부분의 애플리케이션은 두 개 이상의 프레젠테이션(화면 및 프린터)을 캐싱해야 하며 처리기와 다른 형식 또는 위치로 데이터를 캐싱해야 할 수 있으므로 애플리케이션은 개체를 만드는 동안 데이터 캐시(예: 개체 삽입, 파일에서 개체 삽입 및 붙여넣기)를 만들기 위해 일반적으로 개체 서버를 여러 번 시작하고 종료해야 합니다.

이러한 생성 함수의 확장 버전은 이 문제를 해결합니다. OleCreateEx, OleCreateFromFileEx, OleCreateFromDataEx, OleCreateLinkEx, OleCreateLinkToFileEx 및 OleCreateLinkFromDataEx에는 추가 옵션을 나타내는 dwFlags, ADVF 열거형에서 캐시할 형식 수를 나타내는 cFormats, 캐시할 각 형식에 대한 조언 플래그를 지정하는 cFormats, pAdviseSink 프레젠테이션(기본 처리기) 또는 데이터(기본 처리기가 아닌 처리기) 캐싱이 필요한지 여부를 나타내려면 IDataObject::D Advise 쿠키를 반환하는 rgdwConnection과 단일 형식이 아닌 형식 배열인 rgFormatEtc입니다.

개체의 처리기를 대신하여 여러 프레젠테이션을 캐시해야 하는 컨테이너는 이러한 함수를 호출하고 cFormats의 형식 수, rgAdvf의 각 형식에 대한 ADVF 플래그 및 rgFormatEtc의 형식 집합을 지정할 수 있습니다. 이러한 컨테이너는 pAdviseSink에 대해 NULL을 전달합니다.

자체 데이터 또는 프레젠테이션 캐싱을 모두 수행하는 컨테이너는 동일한 단계를 수행하지만 NULL이 아닌 pAdviseSink를 전달합니다. IAdviseSink::OnDataChange 중에 개체 또는 데이터의 자체 캐싱 또는 조작을 수행합니다. 일반적으로 이러한 컨테이너는 ADVF_NODATA 대한 권고 연결을 설정하지 않지만 그렇게 할 수 없습니다.

이러한 새로운 함수는 OLE 복합 문서를 위한 것입니다. 애플리케이션은 이러한 함수를 사용하여 현재 함수에 필요한 반복된 시작 및 초기화 단계를 방지할 수 있습니다. 기본 데이터 및 프레젠테이션 캐싱을 사용하는 OLE 복합 문서 컨테이너 애플리케이션과 기본 IDataObject::D Advise 지원에서 자체 캐싱 및 데이터 전송을 제공하는 애플리케이션을 대상으로 합니다.

요구 사항

추가 정보

ADVF

Formatetc

IAdviseSink::OnDataChange

IDataObject::D Advise

IOleCache::Cache

IOleObject::SetClientSite

IStorage

OLERENDER

OleCreateFromFile