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

아티클
03/09/2024

XPS OM의 내용을 XPS 패키지에 쓰기 위한 스트림을 엽니다.

구문

HRESULT CreatePackageWriterOnStream(
  [in]          ISequentialStream         *outputStream,
  [in]          BOOL                      optimizeMarkupSize,
  [in]          XPS_INTERLEAVING          interleaving,
  [in]          IOpcPartUri               *documentSequencePartName,
  [in]          IXpsOMCoreProperties      *coreProperties,
  [in]          IXpsOMImageResource       *packageThumbnail,
  [in]          IXpsOMPrintTicketResource *documentSequencePrintTicket,
  [in]          IOpcPartUri               *discardControlPartName,
  [out, retval] IXpsOMPackageWriter       **packageWriter
);

매개 변수

[in] outputStream

쓰기에 사용할 스트림입니다.

[in] optimizeMarkupSize

문서가 스트림에 기록될 때 문서 태그가 크기에 맞게 최적화되는지 여부를 나타내는 부울 값입니다.

값	의미
TRUE	스트림에 쓸 때 패키지 작성기는 최소 크기에 대한 태그를 최적화하려고 시도합니다.
FALSE	패키지에 쓸 때 패키지 작성기는 최적화를 시도하지 않습니다.

[in] interleaving

XPS OM의 콘텐츠가 스트림에 기록될 때 인터리브될지 여부를 지정합니다.

[in] documentSequencePartName

새 파일에서 문서 시퀀스의 파트 이름을 포함하는 IOpcPartUri 인터페이스입니다.

[in] coreProperties

새 파일에 부여할 핵심 문서 속성을 포함하는 IXpsOMCoreProperties 인터페이스입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

[in] packageThumbnail

새 파일에 할당할 썸네일 이미지가 포함된 IXpsOMImageResource 인터페이스입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

[in] documentSequencePrintTicket

새 파일에 할당할 패키지 수준 인쇄 티켓이 포함된 IXpsOMPrintTicketResource 인터페이스입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

[in] discardControlPartName

삭제 컨트롤 파트의 이름을 포함하는 IOpcPartUri 인터페이스입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

[out, retval] packageWriter

이 메서드에서 만든 새 IXpsOMPackageWriter 인터페이스에 대한 포인터입니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	outputStream, documentSequencePartName 또는 packageWriter 는 NULL입니다.
XPS_E_NO_CUSTOM_OBJECTS	coreProperties, documentSequencePrintTicket 또는 packageThumbnail 은 인식된 인터페이스 구현을 가리키지 않습니다. XPS 문서 API 인터페이스의 사용자 지정 구현은 지원되지 않습니다.

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

설명

스트림을 열고 초기화한 다음 반환된 IXpsOMPackageWriter 인터페이스를 사용하여 콘텐츠 형식, 패키지 관계, 핵심 속성, 문서 시퀀스 리소스 및 문서 시퀀스 관계를 작성합니다.

documentSequencePrintTicket가 NULL로 설정되고 인터리빙 값이 XPS_INTERLEAVING_ON 경우 이 메서드는 빈 작업 수준 인쇄 티켓을 만들고 빈 인쇄 티켓에 관계를 추가합니다. 이 작업은 패키지의 보다 효율적인 스트리밍 사용을 제공하기 위해 수행됩니다.

documentSequencePrintTicket가 NULL로 설정되어 있고 인터리빙 값이 XPS_INTERLEAVING_OFF 경우 빈 인쇄 티켓이 만들어지지 않습니다.

요구 사항

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