IXpsOMPackage::WriteToFile 메서드(xpsobjectmodel.h)

아티클
03/13/2024

XPS 패키지를 지정된 파일에 씁니다.

구문

HRESULT WriteToFile(
  [in] LPCWSTR               fileName,
  [in] LPSECURITY_ATTRIBUTES securityAttributes,
  [in] DWORD                 flagsAndAttributes,
  [in] BOOL                  optimizeMarkupSize
);

매개 변수

[in] fileName

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

[in] securityAttributes

두 개의 고유하지만 관련된 데이터 멤버를 포함하는 SECURITY_ATTRIBUTES 구조체:

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

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

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

[in] flagsAndAttributes

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

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

[in] optimizeMarkupSize

파일에 문서 태그를 쓸 때 크기에 맞게 최적화할지 여부를 나타내는 부울 값입니다.

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

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	fileName 은 NULL입니다.

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

설명

optimizeMarkupSize 값은 개별 문서 파트 내의 태그를 최적화할지 여부를 결정합니다. 부품이 인터리빙되는 방식에는 영향을 주지 않습니다.

참고 XPS OM을 파일에 기록해도 XPS 문서의 축소판 그림이 자동으로 만들어지지는 않습니다. XPS 문서의 썸네일을 만들려면 IXpsOMThumbnailGenerator 인터페이스를 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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