IXpsOMPackageWriter::AddResource 메서드(xpsobjectmodel.h)
패키지에 새 파트 리소스를 만듭니다.
구문
HRESULT AddResource(
[in] IXpsOMResource *resource
);
매개 변수
[in] resource
패키지의 새 파트로 추가될 파트 리소스의 IXpsOMResource 인터페이스입니다. 이 매개 변수에 전달될 수 있는 리소스 유형은 설명을 참조하세요.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표의 값이 포함되지만 이에 국한되지는 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.
반환 코드 | Description |
---|---|
|
메서드가 성공했습니다. |
|
리소스에서 참조하는 리소스와 이름이 같은 리소스 가 스트림에 이미 추가되었거나 리소스에서 참조하는 리소스를 포함하는 관계가 없습니다.
E_INVALIDARG 반환되면 스트림 또는 파일이 더 이상 유효하지 않으며 Close는 XPS_E_UNAVAILABLE_PACKAGE 반환합니다. |
|
심각한 오류가 발생하여 XPS OM의 내용을 복구할 수 없을 수 있습니다. XPS OM의 일부 구성 요소는 여전히 사용할 수 있지만 확인된 후에만 사용할 수 있습니다. 이 오류가 반환된 후에는 XPS OM의 상태를 예측할 수 없으므로 XPS OM의 모든 구성 요소를 해제하고 삭제해야 합니다. |
이 메서드는 패키징 API를 호출합니다. 패키징 API 반환 값에 대한 자세한 내용은 패키징 오류를 참조하세요.
설명
이 메서드는 리소스에 해당하는 새 파트를 문서 패키지에 만들고, 리소스 의 내용을 새 파트에 추가한 다음, 새 파트를 닫습니다.
이 메서드가 오류를 반환하면 패키지 작성기를 더 이상 사용할 수 없습니다.
리소스 매개 변수는 다음 중 하나여야 합니다.
- 현재 페이지 또는 이미 추가된 페이지에서 사용되는 글꼴 리소스의 IXpsOMFontResource 인터페이스입니다.
- 현재 페이지 또는 이미 추가된 페이지에 사용되는 이미지 리소스의 IXpsOMImageResource 인터페이스입니다.
- 현재 페이지 또는 이미 추가된 페이지에서 사용되는 색 프로필 리소스의 IXpsOMColorProfileResource 인터페이스입니다.
- 현재 페이지 또는 이미 추가된 페이지에 사용되는 스토리 조각 리소스의 IXpsOMStoryFragmentsResource 인터페이스입니다.
- 현재 문서 또는 이미 추가된 문서에 사용되는 문서 구조 리소스의 IXpsOMDocumentStructureResource 인터페이스입니다.
- 현재 문서 또는 이미 추가된 문서에 사용되는 서명 블록 리소스의 IXpsOMSignatureBlockResource 인터페이스입니다.
리소스에 다음 중 하나가 포함된 경우 이 메서드는 오류를 반환합니다.
- 원격 리소스 사전의 IXpsOMRemoteDictionaryResource 인터페이스입니다.
- 인쇄 티켓의 IXpsOMPrintTicketResource 인터페이스입니다.
- 썸네일 이미지의 IXpsOMImageResource 인터페이스입니다.
이 메서드는 리소스 가 스트림에 이미 추가되었거나 기존 관계가 없는 리소스와 이름이 같은 리소스를 참조할 때 오류를 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | xpsobjectmodel.h |