OleConvertIStorageToOLESTREAMEx 함수(ole2.h)

아티클
02/29/2024

OleConvertIStorageToOLESTREAMEx 함수는 지정된 스토리지 개체를 OLE 2 구조적 스토리지에서 프레젠테이션 데이터를 포함한 OLE 1 스토리지 개체 모델로 변환합니다. 이는 OLE1과 OLE2 간의 호환성을 보장하기 위해 Structured Storage에 포함된 여러 함수 중 하나입니다.

구문

HRESULT OleConvertIStorageToOLESTREAMEx(
  [in]  LPSTORAGE   pstg,
  [in]  CLIPFORMAT  cfFormat,
  [in]  LONG        lWidth,
  [in]  LONG        lHeight,
  [in]  DWORD       dwSize,
  [in]  LPSTGMEDIUM pmedium,
  [out] LPOLESTREAM polestm
);

매개 변수

[in] pstg

OLE 1 스토리지로 변환할 스토리지 개체의 IStorage 인터페이스에 대한 포인터입니다.

[in] cfFormat

프레젠테이션 데이터의 형식입니다. NULL일 수 있습니다. 이 경우 lWidth, lHeight, dwSize 및 pmedium 매개 변수는 무시됩니다.

[in] lWidth

개체 프레젠테이션 데이터의 너비(HIMETRIC 단위)입니다.

[in] lHeight

개체 프레젠테이션 데이터의 높이(HIMETRIC 단위)입니다.

[in] dwSize

변환할 데이터의 크기(바이트)입니다.

[in] pmedium

변환할 직렬화된 데이터에 대한 STGMEDIUM 구조체에 대한 포인터입니다.

[out] polestm

OLE 1 스토리지 모델을 사용하여 개체의 영구 표현을 저장하는 스트림에 대한 포인터입니다.

반환 값

이 함수는 다음 외에도 E_INVALIDARG 표준 반환 값을 지원합니다.

설명

OleConvertIStorageToOLESTREAMEx 함수는 OLE 2 스토리지 개체를 OLE 1 형식으로 변환합니다. OleConvertIStorageToOLESTREAMEx 함수가 프레젠테이션 데이터를 OLE 1 스토리지 개체에 전달하지만 OleConvertIStorageToOLESTREAM 함수는 그렇지 않다는 점에서 OleConvertIStorageToOLESTREAM 함수와 다릅니다.

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

STGMEDIUM의 tymed 멤버 값은 TYMED_HGLOBAL 또는 TYMED_ISTREAM 합니다. 자세한 내용은 TYMED 열거형을 참조하세요. 매체는 OleConvertIStorageToOLESTREAMEx 함수에 의해 해제되지 않습니다.

요구 사항

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