다음을 통해 공유


IXpsOMPackageWriter::AddResource 메서드(xpsobjectmodel.h)

패키지에 새 파트 리소스를 만듭니다.

구문

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

매개 변수

[in] resource

패키지의 새 파트로 추가될 파트 리소스의 IXpsOMResource 인터페이스입니다. 이 매개 변수에 전달될 수 있는 리소스 유형은 설명을 참조하세요.

반환 값

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

반환 코드 Description
S_OK
메서드가 성공했습니다.
E_INVALIDARG
리소스에서 참조하는 리소스와 이름이 같은 리소스 가 스트림에 이미 추가되었거나 리소스에서 참조하는 리소스를 포함하는 관계가 없습니다.

E_INVALIDARG 반환되면 스트림 또는 파일이 더 이상 유효하지 않으며 CloseXPS_E_UNAVAILABLE_PACKAGE 반환합니다.

XPS_E_UNAVAILABLE_PACKAGE
심각한 오류가 발생하여 XPS OM의 내용을 복구할 수 없을 수 있습니다. XPS OM의 일부 구성 요소는 여전히 사용할 수 있지만 확인된 후에만 사용할 수 있습니다. 이 오류가 반환된 후에는 XPS OM의 상태를 예측할 수 없으므로 XPS OM의 모든 구성 요소를 해제하고 삭제해야 합니다.
 

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

설명

이 메서드는 리소스에 해당하는 새 파트를 문서 패키지에 만들고, 리소스 의 내용을 새 파트에 추가한 다음, 새 파트를 닫습니다.

이 메서드가 오류를 반환하면 패키지 작성기를 더 이상 사용할 수 없습니다.

리소스 매개 변수는 다음 중 하나여야 합니다.

  • 현재 페이지 또는 이미 추가된 페이지에서 사용되는 글꼴 리소스의 IXpsOMFontResource 인터페이스입니다.
  • 현재 페이지 또는 이미 추가된 페이지에 사용되는 이미지 리소스의 IXpsOMImageResource 인터페이스입니다.
  • 현재 페이지 또는 이미 추가된 페이지에서 사용되는 색 프로필 리소스의 IXpsOMColorProfileResource 인터페이스입니다.
  • 현재 페이지 또는 이미 추가된 페이지에 사용되는 스토리 조각 리소스의 IXpsOMStoryFragmentsResource 인터페이스입니다.
  • 현재 문서 또는 이미 추가된 문서에 사용되는 문서 구조 리소스의 IXpsOMDocumentStructureResource 인터페이스입니다.
  • 현재 문서 또는 이미 추가된 문서에 사용되는 서명 블록 리소스의 IXpsOMSignatureBlockResource 인터페이스입니다.

리소스에 다음 중 하나가 포함된 경우 이 메서드는 오류를 반환합니다.

이 메서드는 리소스 가 스트림에 이미 추가되었거나 기존 관계가 없는 리소스와 이름이 같은 리소스를 참조할 때 오류를 반환합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 xpsobjectmodel.h

추가 정보

IXpsOMPackageWriter

IXpsOMPackageWriter3D

IXpsOMResource

패키징 오류

IXpsOMPackageWriter 인터페이스 사용

XML Paper Specification

XPS 문서 오류