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

아티클
03/05/2024

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	filename, 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