IXpsOMDictionary::Append 메서드(xpsobjectmodel.h)

아티클
12/22/2023

사전 끝에 해당 키와 함께 IXpsOMShareable 인터페이스를 추가합니다.

구문

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

매개 변수

[in] key

이 항목에 사용할 키입니다.

키에서 참조하는 문자열은 사전에서 고유해야 합니다.

[in] entry

사전에 추가할 IXpsOMShareable 인터페이스에 대한 포인터입니다.

사전에 중복 인터페이스 포인터를 포함할 수 없습니다. 이 매개 변수는 사전에 없는 인터페이스 포인터를 포함해야 합니다.

반환 값

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

반환 코드	설명
S_OK	메서드가 성공했습니다.
XPS_E_NO_CUSTOM_OBJECTS	항목 은 인식된 인터페이스 구현을 가리키지 않습니다. XPS 문서 API 인터페이스의 사용자 지정 구현은 지원되지 않습니다.

설명

사전에 저장된 인터페이스 포인터는 일반적으로 IXpsOMShareable 인터페이스에서 파생된 IXpsOMBrush 및 IXpsOMVisual과 같은 인터페이스 를 가리킵니다. 인터페이스 형식을 확인하려면 IXpsOMShareable::GetType 메서드를 호출합니다.

다음 그림에서는 Append 메서드에 의해 사전이 변경되는 방법을 보여 줍니다.

요구 사항


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