IXpsOMObjectFactory::CreatePackageFromStream 메서드(xpsobjectmodel.h)

아티클
03/05/2024

XPS 패키지가 포함된 스트림을 열고 인스턴스화된 XPS 문서 개체 트리를 반환합니다.

구문

HRESULT CreatePackageFromStream(
  [in]          IStream       *stream,
  [in]          BOOL          reuseObjects,
  [out, retval] IXpsOMPackage **package
);

매개 변수

[in] stream

XPS 패키지가 포함된 스트림입니다.

[in] reuseObjects

소프트웨어가 모든 속성 및 자식에서 동일한 개체를 공유하여 문서 개체 트리를 최적화하려고 시도했음을 나타내는 부울 값입니다.

값	의미
TRUE	소프트웨어는 개체 트리를 최적화하려고 시도합니다.
FALSE	소프트웨어는 개체 트리를 최적화하려고 시도하지 않습니다.

[out, retval] package

결과 XPS 문서 개체 트리를 포함하는 새 IXpsOMPackage 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	스트림 또는 패키지 가 NULL입니다.

이 메서드는 패키징 API를 호출합니다. 패키징 API 반환 값에 대한 자세한 내용은 패키징 오류를 참조하세요.

설명

이 메서드는 스트림에서 XPS OM의 개체로 로드하는 스트림 기반 리소스의 콘텐츠의 유효성을 검사하지 않습니다. 대신 애플리케이션은 이러한 리소스를 사용하기 전에 유효성을 검사해야 합니다.

이 메서드는 문서 페이지를 역직렬화하지 않습니다. XPS 패키지를 페이지 참조 부분으로만 역직렬화합니다. IXpsOMPageReference::GetPage 메서드를 호출하여 필요에 따라 실제 페이지를 역직렬화할 수 있습니다. GetPage가 호출될 때 페이지가 역직렬화되지 않으므로 이 메서드는 S_OK 반환하거나 XPS 패키지에 문제가 있는 페이지를 로드하려고 하면 오류를 반환할 수 있습니다.

XPS 패키지를 읽은 직후 XPS OM을 작성하는 경우 원래 콘텐츠 중 일부가 손실되거나 변경될 수 있습니다.

이러한 경우에 발생할 수 있는 변경 내용 중 일부는 다음 표에 나열됩니다.

문서 기능	작업
디지털 서명	문서에서 제거됨
DiscardControl 부분	문서에서 제거됨
외문 문서 파트	문서에서 제거됨
FixedPage 태그	원본에서 수정됨
리소스 사전 태그	최적화 플래그가 설정된 경우 원본에서 수정됨

프로그램에서 IXpsOMPackage 인터페이스를 사용하는 방법에 대한 자세한 내용은 빈 XPS OM 만들기를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel.h