다음을 통해 공유

OleLoadFromStream 함수(ole2.h)

  • 아티클

스트림에서 개체를 로드합니다.

구문

HRESULT OleLoadFromStream(
  [in]  LPSTREAM pStm,
  [in]  REFIID   iidInterface,
  [out] LPVOID   *ppvObj
);

매개 변수

[in] pStm

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

[in] iidInterface

호출자가 로드된 후 개체와 통신하는 데 사용하려는 IID(인터페이스 식별자)입니다.

[out] ppvObj

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

반환 값

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

반환 코드 설명
E_OUTOFMEMORY
 작업에 대한 메모리가 부족합니다.
E_NOINTERFACE
 개체는 지정된 인터페이스를 지원하지 않습니다.
 

이 함수는 ReadClassStm 및 CoCreateInstance 함수 및 IPersistStream::Load 메서드에서 반환하는 오류 값을 반환할 수도 있습니다.

설명

중요  

보안 참고: 신뢰할 수 없는 데이터로 이 메서드를 호출하는 것은 보안 위험입니다. 신뢰할 수 있는 데이터로만 이 메서드를 호출하세요.

 
이 함수는 IPersistStream 인터페이스를 지원하는 개체를 로드하는 데 사용할 수 있습니다. 개체의 CLSID는 스트림에서 개체의 데이터 바로 앞에 와야 합니다. 이 데이터는 도우미 함수 OleSaveToStream (또는 해당 항목에서 설명하는 래핑 작업)에 의해 수행됩니다.

스트림에 대한 CLSID가 CLSID_NULL 경우 ppvObj 매개 변수는 NULL로 설정됩니다.

요구 사항

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

추가 정보

OleSaveToStream