IXpsOMPage::GetDictionary 메서드(xpsobjectmodel.h)

이 페이지와 연결된 확인된 IXpsOMDictionary 인터페이스에 대한 포인터를 가져옵니다.

구문

HRESULT GetDictionary(
  [out, retval] IXpsOMDictionary **resourceDictionary
);

[out, retval] resourceDictionary

이 페이지와 연결된 확인된 IXpsOMDictionary 인터페이스에 대한 포인터입니다.

이 매개 변수에서 반환되는 값은 사전을 설정하기 위해 가장 최근에 호출된 메서드에 따라 달라집니다.

호출된 가장 최근의 메서드	resourceDictionary에 반환되는 개체
SetDictionaryLocal	SetDictionaryLocal에 의해 설정된 로컬 사전 리소스입니다.
SetDictionaryResource	SetDictionaryResource에서 설정한 사전 리소스의 공유 사전입니다.
SetDictionaryLocal 또는 SetDictionaryResource는 아직 호출되지 않았습니다.	NULL 포인터입니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	resourceDictionary 가 NULL입니다.
XPS_E_LOOKUP_INVALID_TYPE	SetStrokeBrushLookup에서 설정한 조회 키 이름은 브러시가 아닌 개체를 참조합니다.
XPS_E_LOOKUP_NOT_FOUND	조회 값과 일치하는 키 이름을 가진 개체를 찾을 수 없습니다. 조회에 전달된 값과 일치하는 키 이름을 가진 개체를 찾을 수 없습니다.

사전이 로컬인지 아니면 원격 사전 리소스에 포함되어 있는지 여부에 관계없이 이 메서드는 IXpsOMDictionary 인터페이스 포인터를 반환합니다. GetOwner는 사전이 원격인지 여부를 결정합니다.

페이지에 원격 사전이 포함된 경우 GetDictionary 는 사전을 역직렬화합니다. 페이지에 유효하지 않은 원격 사전이 포함되어 있으면 GetDictionary 에서 역직렬화 오류 코드를 반환할 수 있습니다.

리소스를 로드하고 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