다음을 통해 공유

TTGetEmbeddedFontInfo 함수(t2embapi.h)

  • 아티클

포함 권한과 같은 포함된 글꼴에 대한 정보를 검색합니다. TTGetEmbeddedFontInfo 는 TTLoadEmbeddedFont 와 동일한 작업을 수행하지만 포함된 글꼴에 대한 내부 데이터 구조를 할당하지 않습니다.

구문

LONG TTGetEmbeddedFontInfo(
  [in]  ULONG         ulFlags,
  [out] ULONG         *pulPrivStatus,
  [in]  ULONG         ulPrivs,
  [out] ULONG         *pulStatus,
        READEMBEDPROC lpfnReadFromStream,
  [in]  LPVOID        lpvReadStream,
  [in]  TTLOADINFO    *pTTLoadInfo
);

매개 변수

[in] ulFlags

요청을 지정하는 플래그입니다. 이 플래그는 다음 값 중 0개 이상을 가질 수 있습니다.

값 의미
TTEMBED_EMBEDEUDC
 연결된 EUDC 글꼴 파일 데이터를 글꼴 구조에 포함합니다.
TTEMBED_RAW
 압축되지 않은 전체 문자 집합을 포함하는 글꼴 구조를 반환합니다. 함수의 기본 동작입니다.
TTEMBED_SUBSET
 pusCharCodeSet 또는 pulCharCodeSet 매개 변수로 표시된 문자 모양만 포함하는 하위 집합 글꼴을 반환합니다. 이러한 문자 코드는 매개 변수에 적합한 16비트 또는 UCS-4 문자로 표시되어야 합니다.
TTEMBED_TTCOMPRESSED
 압축된 글꼴 구조를 반환합니다.

[out] pulPrivStatus

완료되면 글꼴의 포함 권한을 나타냅니다. 가능한 값 목록은 다음과 같습니다.

값 의미
EMBED_PREVIEWPRINT
 미리 보기 및 인쇄 포함.
EMBED_EDITABLE
 편집 가능한 포함.
EMBED_INSTALLABLE
 설치 가능한 포함.
EMBED_NOEMBEDDING
 제한된 라이선스 포함.

[in] ulPrivs

클라이언트가 적용한 추가 권한 포함 제한을 나타내는 플래그입니다. 자세한 내용은 TTLoadEmbeddedFont 를 참조하세요.

이 플래그에는 다음 값 중 하나가 있어야 합니다.

값 의미
LICENSE_PREVIEWPRINT
 미리 보기 및 인쇄 포함.
LICENSE_EDITABLE
 편집 가능한 포함.
LICENSE_INSTALLABLE
 설치 가능한 포함.
LICENSE_NOEMBEDDING
 제한된 라이선스 포함.
LICENSE_DEFAULT
 기본 포함 수준을 사용합니다.

[out] pulStatus

상태 정보를 포함하는 비트 필드에 대한 포인터이며 이 함수가 완료되면 채워집니다. 상태 0 또는 다음 값일 수 있습니다.

값 의미
TTLOAD_FONT_SUBSETTED
 로드된 글꼴은 원래 글꼴의 하위 집합입니다.

lpfnReadFromStream

[콜백] 문서 스트림에서 글꼴 구조를 읽는 클라이언트 정의 콜백 함수에 대한 포인터입니다.

[in] lpvReadStream

현재 정의되지 않았습니다. 스트림(글꼴 구조)에 대한 포인터용으로 예약됩니다.

[in] pTTLoadInfo

포함된 글꼴 개체를 가져온 URL을 포함하는 TTLOADINFO 구조체에 대한 포인터입니다.

반환 값

성공하면 E_NONE 반환합니다.

*pulPrivStatus 에서 참조하는 위치는 글꼴의 포함 권한을 식별합니다. *pulStatus 에서 참조하는 위치는 글꼴의 하위 집합이 포함되는지 여부를 식별합니다.

그렇지 않으면 Embedding-Function 오류 메시지에 설명된 오류 코드를 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 t2embapi.h
라이브러리 T2embed.lib
DLL T2embed.dll

추가 정보

TTGetEmbeddingType

TTGetNewFontName

TTLOADINFO

TTLoadEmbeddedFont