IXpsOMPackage1::WriteToFile1 메서드(xpsobjectmodel_1.h)

XPS OM을 지정된 형식의 XPS 패키지로 파일에 씁니다.

구문

HRESULT WriteToFile1(
  LPCWSTR               fileName,
  LPSECURITY_ATTRIBUTES securityAttributes,
  DWORD                 flagsAndAttributes,
  BOOL                  optimizeMarkupSize,
  XPS_DOCUMENT_TYPE     documentType
);

매개 변수

fileName

[in, string] 만들 파일의 이름입니다. 이 매개 변수는 NULL이 아니어야 합니다.

securityAttributes

[in, unique] 두 개의 고유하지만 관련된 데이터 멤버를 포함하는 SECURITY_ATTRIBUTES 구조체입니다.

lpSecurityDescriptor: 선택적 보안 설명자

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

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

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

flagsAndAttributes

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

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

optimizeMarkupSize

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

TRUE: 패키지 작성기는 최소 크기에 대한 태그를 최적화하려고 합니다.

FALSE: 패키지 작성기는 최적화를 수행하지 않습니다.

documentType

[in] outputStream에 쓸 XPS 데이터 형식입니다. 이 매개 변수의 값은 XPS_DOCUMENT_TYPE_UNSPECIFIED 수 없습니다.

반환 값

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

S_OK: 메서드가 성공했습니다.

E_POINTER: documentType이 NULL입니다.

E_INVALIDARG: 문서 형식이 XPS_DOCUMENT_TYPE_UNSPECIFIED 지정되었습니다.

XPS_E_INVALID_CONTENT_TYPE: 패키지의 이미지 리소스는 documentType에 지정된 문서 형식에서 지원되지 않는 형식입니다.

설명

호출자는 패키지의 모든 이미지 리소스가 패키지 유형에서 지원되는지 확인해야 합니다. 예를 들어 JpegXR 이미지는 호환되지 않으므로 MSXPS 문서 형식에서 사용할 수 없습니다.

요구 사항

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

참고 항목

IXpsOMPackage1