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

사전의 지정된 위치에 있는 항목을 바꿉니다.

구문

HRESULT SetAt(
  [in] UINT32          index,
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

[in] index

항목을 바꿀 사전의 인덱스(0부터 시작)입니다.

[in] key

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

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

[in] entry

인덱스로 지정된 위치에 있는 현재 콘텐츠를 대체할 IXpsOMShareable 인터페이스 포인터입니다.

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

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

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

인덱스로 지정된 위치에서 이 메서드는 기존 포인터에서 참조하는 IXpsOMShareable 인터페이스를 해제한 다음, 해당 인터페이스를 항목에 전달된 인터페이스 포인터로 바꾸고 키에 전달된 키를 할당합니다.

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

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


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