IXpsOMObjectFactory1::CreatePackageWriterOnFile1 메서드(xpsobjectmodel_1.h)

아티클
11/20/2024

XPS OM의 내용을 지정된 형식의 XPS 패키지에 쓰기 위한 파일을 엽니다. 이 메서드는 MSXPS 문서 또는 OpenXPS 문서에 대한 패키지 작성기를 생성합니다.

통사론

HRESULT CreatePackageWriterOnFile1(
  LPCWSTR                   fileName,
  LPSECURITY_ATTRIBUTES     securityAttributes,
  DWORD                     flagsAndAttributes,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

매개 변수

fileName

[in] 만들 파일의 이름입니다.

securityAttributes

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

lpSecurityDescriptor: 선택적 보안 설명자
bInheritHandle: 반환된 핸들을 자식 프로세스에서 상속할 수 있는지 여부를 결정하는 부울 값입니다.

lpSecurityDescriptor NULL경우 반환된 핸들과 연결된 파일 또는 디바이스에 기본 보안 설명자가 할당됩니다.

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

flagsAndAttributes

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

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

optimizeMarkupSize

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

값	의미
TRUE	패키지 작성기는 최소 크기로 태그를 최적화하려고 합니다.
FALSE	패키지 작성기는 최적화를 수행하지 않습니다.

interleaving

[in] XPS OM의 내용이 파일에 기록될 때 인터리브될지 여부를 지정합니다.

documentSequencePartName

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

coreProperties

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

packageThumbnail

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

documentSequencePrintTicket

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

discardControlPartName

[in] 무시 컨트롤 파트의 이름을 포함하는 IOpcPartUri 인터페이스입니다. 이 매개 변수는 NULL설정할 수 있습니다.

documentType

[in] 패키지 작성기의 문서 형식을 지정합니다. 이 매개 변수의 값은 XPS_DOCUMENT_TYPE_UNSPECIFIED 수 없습니다.

packageWriter

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

반환 값

가능한 값은 다음을 포함하지만 제한되지는 않습니다. 여기에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

S_OK: 메서드가 성공했고 packageWriter가 올바르게 설정되었습니다.

E_INVALIDARG: 문서 형식이 유효한 XPS 문서 형식이 아닙니다.

발언

이 메서드를 사용하여 MSXPS 문서 또는 OpenXPS 문서에 대한 패키지 작성기를 생성합니다. Windows 7에서 릴리스된 CreatePackageWriterOnFileMSXPS 형식으로 XPS 문서 파일만 만듭니다.

추가 참조

추가 참조: 레거시 메서드 설명

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel_1.h
라이브러리	없음

참고 항목

IXpsOMObjectFactory1

다음을 통해 공유