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

아티클
03/05/2024

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

구문

HRESULT Load(
  [in] IStream *pStm
);

매개 변수

[in] pStm

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

반환 값

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

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

설명

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

발신자에 대한 참고 사항

IPersistStream::Load를 직접 호출하는 대신 일반적으로 OleLoadFromStream 함수를 호출하면 다음이 수행됩니다.

ReadClassStm 함수를 호출하여 스트림에서 클래스 식별자를 가져옵니다.
CoCreateInstance 함수를 호출하여 개체의 instance 만듭니다.
IPersistStream에 대한 instance 쿼리합니다.
IPersistStream::Load를 호출합니다.

OleLoadFromStream 함수는 개체가 클래스 식별자 뒤에 개체 데이터가 있는 스트림에 저장된다고 가정합니다. 이 스토리지 패턴은 OLE에서 제공하는 제네릭 복합 모니커 구현에서 사용됩니다.

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

URL 모니커 노트

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

요구 사항

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

추가 정보

IPersistStream

Share via