IXpsOMGlyphsEditor::SetGlyphMappings 메서드(xpsobjectmodel.h)

UnicodeString 속성의 UTF-16 스칼라 값을 XPS_GLYPH_INDEX 구조체 배열의 항목에 매핑하는 방법을 설명하는 XPS_GLYPH_MAPPING 구조체의 배열을 설정합니다.

구문

HRESULT SetGlyphMappings(
  [in] UINT32                  glyphMappingCount,
  [in] const XPS_GLYPH_MAPPING *glyphMappings
);

[in] glyphMappingCount

glyphMappings에서 참조하는 배열의 XPS_GLYPH_MAPPING 구조체 수입니다. 값이 0이면 속성이 지워지게 됩니다.

[in] glyphMappings

문자 모양 매핑 값을 포함하는 XPS_GLYPH_MAPPING 구조체 배열입니다. glyphMappingCount가 0이면 이 매개 변수는 무시되며 NULL로 설정할 수 있습니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_INVALIDARG	하나 이상의 XPS_GLYPH_MAPPING 구조체의 멤버에는 유효하지 않은 값이 있습니다. 문자열 길이와 시작 위치의 합계가 시작 위치보다 작은 경우 이 문제가 발생할 수 있습니다. 인덱스 위치와 인덱스 길이의 합계가 시작 위치보다 작습니다. 인덱스의 길이는 0입니다.
E_POINTER	glyphMappings 는 NULL 이고 glyphMappingCount 는 0보다 큽니다.
XPS_E_MAPPING_OUT_OF_ORDER	하나 이상의 XPS_GLYPH_MAPPING 구조에서 요소는 순서가 벗어났습니다.

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