Share via

OleSaveToStream 함수(ole.h)

  • 아티클

IPersistStream 인터페이스가 있는 개체를 지정된 스트림에 저장합니다.

구문

OLESTATUS OleSaveToStream(
  LPOLEOBJECT unnamedParam1,
  LPOLESTREAM unnamedParam2
);

매개 변수

unnamedParam1

스트림에 저장할 개체의 IPersistStream 인터페이스에 대한 포인터입니다. pPStm 매개 변수는 NULL일 수 없습니다.

unnamedParam2

개체를 저장할 스트림의 IStream 인터페이스에 대한 포인터입니다.

반환 값

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

반환 코드 설명
STGMEDIUM_E_FULL
 디스크 공간이 부족하여 개체를 저장할 수 없습니다.
OLE_E_BLANK
 pPStm 매개 변수는 NULL입니다.
 

이 함수는 WriteClassStm 함수 또는 IPersistStream::Save 메서드에서 반환된 오류 값을 반환할 수도 있습니다.

설명

이 함수는 IPersistStream 인터페이스를 구현하는 개체를 스트림에 저장하는 것을 간소화합니다. 이 스트림에서 개체의 CLSID는 해당 데이터보다 우선합니다. 스트림이 검색되면 CLSID는 적절한 코드를 데이터와 연결할 수 있도록 허용합니다. OleSaveToStream 함수는 다음을 수행합니다.

  • IPersist::GetClassID 메서드를 호출하여 개체의 CLSID를 가져옵니다.
  • WriteClassStm 함수를 사용하여 CLSID를 스트림에 씁니다.
  • fClearDirty가 TRUE로 설정된 IPersistStream::Save 메서드를 호출하여 개체의 더티 비트를 지웁니다.
도우미인 OleLoadFromStream은 이러한 방식으로 저장된 개체를 로드합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ole.h(Ole2.h 포함)
라이브러리 Ole32.lib
DLL Ole32.dll
API 세트 ext-ms-win-com-ole32-l1-1-1(Windows 8.1 도입)

추가 정보

IPersistStream

IStream

OleLoadFromStream