IXpsOMDictionary::InsertAt 메서드(xpsobjectmodel.h)
사전의 지정된 위치에 IXpsOMShareable 인터페이스를 삽입하고 인터페이스를 식별하도록 키를 설정합니다.
구문
HRESULT InsertAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
매개 변수
[in] index
IXpsOMShareable 인터페이스를 삽입할 사전의 인덱스(0부터 시작)입니다.
[in] key
사전에서 IXpsOMShareable 인터페이스를 식별하는 데 사용할 키입니다.
키에서 참조하는 문자열은 사전에서 고유해야 합니다.
[in] entry
인덱스로 지정된 위치에 삽입할 IXpsOMShareable 인터페이스 포인터입니다.
사전에 중복 인터페이스 포인터를 포함할 수 없습니다. 이 매개 변수는 사전에 없는 인터페이스 포인터를 포함해야 합니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.
| 반환 코드 | Description |
|---|---|
|
메서드가 성공했습니다. |
|
항목 은 인식된 인터페이스 구현을 가리키지 않습니다. XPS 문서 API 인터페이스의 사용자 지정 구현은 지원되지 않습니다. |
설명
사전에 저장된 인터페이스 포인터는 일반적으로 IXpsOMShareable 인터페이스에서 파생된 IXpsOMBrush 및 IXpsOMVisual과 같은 인터페이스에 대한 포인터입니다. 인터페이스 형식을 확인하려면 IXpsOMShareable::GetType 메서드를 호출합니다.
인덱스로 지정된 위치에서 이 메서드는 IXpsOMShareable 인터페이스 포인터를 삽입하고 키를 설정합니다. 인터페이스 포인터와 키는 각각 값과 키로 전달됩니다. 값과 키를 삽입하기 전에 이 위치와 모든 후속 위치의 인터페이스 포인터와 키가 하나의 인덱스로 위로 이동합니다.
다음 그림에서는 InsertAt 메서드에 의해 사전이 변경되는 방법을 보여 줍니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 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 |