IXpsOMDocument::GetPageReferences 메서드(xpsobjectmodel.h)

아티클
12/22/2023

페이지의 가상화된 액세스를 허용하는 문서의 IXpsOMPageReferenceCollection 인터페이스를 가져옵니다.

구문

HRESULT GetPageReferences(
  [out, retval] IXpsOMPageReferenceCollection **pageReferences
);

매개 변수

[out, retval] pageReferences

문서의 각 페이지에 대한 페이지 참조 컬렉션이 포함된 IXpsOMPageReferenceCollection 인터페이스에 대한 포인터입니다. 페이지 참조가 없는 경우 pageReferences에 반환된 IXpsOMPageReferenceCollection은 비어 있고 요소가 없습니다.

반환 값

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

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

설명

문서의 페이지를 얻으려면 먼저 GetPageReferences를 호출하여 IXpsOMPageReference 인터페이스 목록을 가져옵니다. 그런 다음 각 IXpsOMPageReference 인터페이스에 대해 GetPage를 호출하여 페이지를 로드합니다.

문서에 페이지가 없으면 pageReferences 에 반환된 페이지 참조 컬렉션이 비어 있습니다. 컬렉션에서 페이지 참조 수를 얻으려면 GetCount 메서드를 호출합니다.

프로그램에서 이 메서드를 사용하는 방법에 대한 예제는 XPS OM 탐색을 참조하세요.

요구 사항

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