OleConvertOLESTREAMToIStorageEx 함수(ole2.h)

아티클
08/25/2023

OleConvertOLESTREAMToIStorageEx 함수는 지정된 개체를 OLE 1 스토리지 모델에서 프레젠테이션 데이터를 포함한 OLE 2 구조적 스토리지 개체로 변환합니다. 이는 여러 호환성 함수 중 하나입니다.

구문

HRESULT OleConvertOLESTREAMToIStorageEx(
  [in]  LPOLESTREAM polestm,
  [out] LPSTORAGE   pstg,
  [out] CLIPFORMAT  *pcfFormat,
  [out] LONG        *plwWidth,
  [out] LONG        *plHeight,
  [out] DWORD       *pdwSize,
  [out] LPSTGMEDIUM pmedium
);

매개 변수

[in] polestm

OLE 1 스토리지 형식의 개체의 영구 표현을 포함하는 스트림에 대한 포인터입니다.

[out] pstg

OLE 2 구조적 스토리지 개체에 대한 포인터입니다.

[out] pcfFormat

프레젠테이션 데이터의 형식이 반환되는 위치에 대한 포인터입니다. 프레젠테이션 데이터가 없음을 나타내는 NULL일 수 있습니다.

[out] plwWidth

프레젠테이션 데이터의 너비 값(HIMETRIC)이 반환되는 위치에 대한 포인터입니다.

[out] plHeight

프레젠테이션 데이터의 높이 값(HIMETRIC)이 반환되는 위치에 대한 포인터입니다.

[out] pdwSize

변환된 데이터의 크기(바이트)가 반환되는 위치에 대한 포인터입니다.

[out] pmedium

변환된 직렬화된 데이터에 대한 STGMEDIUM 구조체가 반환되는 위치에 대한 포인터입니다.

반환 값

이 함수는 HRESULT를 반환합니다.

설명

이 함수는 OLE 1 개체를 OLE 2 구조적 스토리지 개체로 변환합니다. 새 버전의 개체 애플리케이션에서 OLE 2를 지원하는 경우 이 함수를 사용하여 OLE 1 개체를 OLE 2 개체로 업데이트할 수 있습니다.

이 함수는 OLESTREAM 구조에서 읽은 프레젠테이션 데이터가 전달되고 새로 만든 OLE 2 스토리지 개체에 프레젠테이션 스트림이 포함되어 있지 않다는 점에서 OleConvertOLESTREAMToIStorage 함수와 다릅니다.

이 함수는 변환할 프레젠테이션 데이터를 지정할 수 있으므로 OLE의 기본 캐싱 리소스를 사용하지 않지만 변환 리소스를 사용하는 애플리케이션에서 사용할 수 있습니다.

STGMEDIUM의 tymed 멤버는 TYMED_NULL 또는 TYMED_ISTREAM 수 있습니다. TYMED_NULL 경우 데이터가 STGMEDIUM의 hGlobal 멤버를 통해 전역 핸들에 반환되고, 그렇지 않으면 데이터가 이 구조체의 pstm 멤버에 기록됩니다.

요구 사항

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