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

아티클
08/28/2023

문서 구조 리소스 스트림에 대한 액세스를 제공하는 IXpsOMDocumentStructureResource 인터페이스를 만듭니다.

구문

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

매개 변수

[in] acquiredStream

이 리소스와 연결할 읽기 전용 IStream 인터페이스입니다. 이 매개 변수는 NULL이 아니어야 합니다.

중요 이 스트림을 STA(Single-Threaded Apartment) 개체로 처리합니다. 다시 입력하지 마세요.

[in] partUri

이 리소스에 할당할 부품 이름을 포함하는 IOpcPartUri 인터페이스입니다. 이 매개 변수는 NULL이 아니어야 합니다.

[out, retval] documentStructureResource

새 IXpsOMDocumentStructureResource 인터페이스에 대한 포인터입니다.

반환 값

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

반환 코드	설명
S_OK	메서드가 성공했습니다.
E_POINTER	acquiredStream, partUri 또는 documentStructureResource 가 NULL입니다.

설명

XPS 문서의 DocumentStructure 부분에는 문서 개요가 포함되어 있으며, StoryFragments 부분을 사용하여 문서의 고정 페이지에 표시되는 모든 요소의 읽기 순서를 정의합니다. 이 인터페이스를 사용하면 프로그램에서 DocumentStructure 부분의 XML 내용을 읽고 DocumentStructure 부분의 XML 콘텐츠를 바꿀 수도 있습니다.

DocumentStructure 부분에는 문서의 전체 읽기 순서를 설명하는 문서 프레임워크와 개요가 포함되어 있습니다. 읽기 순서는 스토리라는 의미 체계 블록으로 구성됩니다. 문서는 잡지의 단위와 동일한 방식으로 문서의 논리적 단위입니다. 이야기는 하나 이상의 StoryFragments 부분으로 구성됩니다.

StoryFragments 파트에는 스토리의 콘텐츠를 구성하는 단락 및 테이블과 같은 스토리의 의미 체계 블록을 정의하는 콘텐츠 구조 태그가 포함되어 있습니다.

DocumentStructure 및 StoryFragments 부분의 내용은 XML 용지 사양에 설명되어 있습니다.

요구 사항


지원되는 최소 클라이언트	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