다음을 통해 공유


IPersistStream::Load 메서드(objidl.h)

이전에 저장한 스트림에서 개체를 초기화합니다.

구문

HRESULT Load(
  [in] IStream *pStm
);

매개 변수

[in] pStm

개체를 로드해야 하는 스트림에 대한 IStream 포인터입니다.

반환 값

이 메서드는 다음 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
메서드가 완료되었습니다.
E_OUTOFMEMORY
메모리 부족으로 인해 개체가 로드되지 않았습니다.
E_FAIL
메모리 부족 이외의 이유로 인해 개체가 로드되지 않았습니다.

설명

이 메서드는 연결된 스트림에서 개체를 로드합니다. 검색 포인터는 가장 최근의 IPersistStream::Save 메서드에서와 같이 설정됩니다. 이 메서드는 스트림에서 검색하고 읽을 수 있지만 쓸 수는 없습니다.

발신자에 대한 참고 사항

IPersistStream::Load를 직접 호출하는 대신 일반적으로 OleLoadFromStream 함수를 호출하면 다음이 수행됩니다.
  1. ReadClassStm 함수를 호출하여 스트림에서 클래스 식별자를 가져옵니다.
  2. CoCreateInstance 함수를 호출하여 개체의 instance 만듭니다.
  3. IPersistStream에 대한 instance 쿼리합니다.
  4. IPersistStream::Load를 호출합니다.
OleLoadFromStream 함수는 개체가 클래스 식별자 뒤에 개체 데이터가 있는 스트림에 저장된다고 가정합니다. 이 스토리지 패턴은 OLE에서 제공하는 제네릭 복합 모니커 구현에서 사용됩니다.

개체가 이 패턴을 사용하여 저장되지 않은 경우 메서드를 직접 호출해야 합니다.

URL 모니커 노트

일반적으로 이전에 IPersistStream::Save ( OleSaveToStream 사용)를 사용하여 이전에 저장된 스트림 내 데이터에서 URL 모니커를 초기화합니다. URL 모니커의 이진 형식은 유니코드의 URL 문자열입니다(전체 또는 부분 URL 문자열일 수 있음, 자세한 내용은 CreateURLMonikerEx 참조). 이는 ULONG 문자 수와 그 뒤에 많은 유니코드 문자로 표시됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 objidl.h

추가 정보

IPersistStream