다음을 통해 공유

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

  • 아티클

XPS OM의 내용을 XPS 패키지에 쓰기 위한 파일을 엽니다.

통사론

HRESULT CreatePackageWriterOnFile(
  [in]          LPCWSTR                   fileName,
  [in]          LPSECURITY_ATTRIBUTES     securityAttributes,
  [in]          DWORD                     flagsAndAttributes,
  [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] fileName

만들 파일의 이름입니다.

[in] securityAttributes

별도의 두 개의 관련 멤버를 포함하는 SECURITY_ATTRIBUTES 구조체입니다.

  • lpSecurityDescriptor: 선택적 보안 설명자
  • bInheritHandle: 반환된 핸들을 자식 프로세스에서 상속할 수 있는지 여부를 결정하는 부울 값입니다.
lpSecurityDescriptor NULL경우 반환된 핸들과 연결된 파일 또는 디바이스에 기본 보안 설명자가 할당됩니다.

securityAttributes대한 자세한 내용은 CreateFile참조하세요.

[in] flagsAndAttributes

만들 파일의 설정과 특성을 지정합니다. 대부분의 파일에서 FILE_ATTRIBUTE_NORMAL 값을 사용할 수 있습니다.

이 매개 변수에 대한 자세한 내용은 CreateFile 참조하세요.

[in] optimizeMarkupSize

XPS OM의 내용이 XPS 패키지에 기록될 때 문서 태그가 크기에 맞게 최적화되는지 여부를 나타내는 부울 값입니다.

값 의미
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 문서 오류참조하세요.

반환 코드 묘사
S_OK
 메서드가 성공했습니다.
E_POINTER
 파일 이름, 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용 플랫폼 업데이트가 있는 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 xpsobjectmodel.h

참고 항목

CreateFile

IXpsOMCoreProperties

IXpsOMImageResource

IXpsOMObjectFactory

IXpsOMPackageWriter

IXpsOMPrintTicketResource

패키징 오류

SECURITY_ATTRIBUTES

XML 용지 사양

XPS 문서 오류