다음을 통해 공유

TTLoadEmbeddedFont 함수(t2embapi.h)

  • 아티클

문서 스트림에서 포함된 글꼴을 읽고 설치합니다. 또한 클라이언트가 글꼴의 포함 권한을 추가로 제한할 수 있습니다.

구문

LONG TTLoadEmbeddedFont(
  [out]          HANDLE        *phFontReference,
  [in]           ULONG         ulFlags,
  [out]          ULONG         *pulPrivStatus,
  [in]           ULONG         ulPrivs,
  [out]          ULONG         *pulStatus,
  [in]           READEMBEDPROC lpfnReadFromStream,
  [in]           LPVOID        lpvReadStream,
  [in, optional] LPWSTR        szWinFamilyName,
  [in, optional] LPSTR         szMacFamilyName,
  [in, optional] TTLOADINFO    *pTTLoadInfo
);

매개 변수

[out] phFontReference

설치된 포함된 글꼴을 식별하는 핸들에 대한 포인터입니다. 이 핸들은 Hfont가 아닌 내부 구조를 참조합니다.

[in] ulFlags

로드 및 설치 옵션을 지정하는 플래그입니다. 현재 이 플래그는 0 또는 다음 값으로 설정할 수 있습니다.

값 의미
TTLOAD_PRIVATE
 글꼴이 사용자에게 열거되지 않도록 로드합니다. 글꼴을 설치할 수 없는 경우 비공개로 유지됩니다.

[out] pulPrivStatus

글꼴의 포함 권한을 나타내는 플래그에 대한 포인터입니다. 이 플래그는 이 함수가 완료될 때 작성되며 다음 값 중 하나를 가질 수 있습니다. 이 함수는 부여된 최소 제한 라이선스를 반환합니다.

값 의미
EMBED_PREVIEWPRINT
 미리 보기 및 인쇄 포함 글꼴은 문서 내에 포함될 수 있지만 원격 시스템에만 일시적으로 설치해야 합니다. 이러한 유형의 글꼴이 포함된 문서는 읽기 전용으로만 열 수 있습니다. 애플리케이션에서 사용자가 문서를 편집할 수 없도록 허용하면 안됩니다. 문서는 보기 및/또는 인쇄만 가능합니다.
EMBED_EDITABLE
 편집 가능한 포함. 글꼴은 문서 내에 포함될 수 있지만 원격 시스템에만 일시적으로 설치해야 합니다. 이러한 유형의 글꼴이 포함된 문서는 편집이 허용된 "읽기/쓰기"를 열 수 있습니다.
EMBED_INSTALLABLE
 설치 가능한 포함. 글꼴이 포함되고 원격 시스템에 영구적으로 설치될 수 있습니다. 원격 시스템의 사용자는 해당 글꼴의 원래 구매자와 동일한 권리, 의무 및 라이선스를 획득하며 원래 구매자와 동일한 최종 사용자 라이선스 계약, 저작권, 디자인 특허 및/또는 상표의 적용을 받습니다.
EMBED_NOEMBEDDING
 제한된 라이선스 포함. 글꼴은 먼저 법적 소유자의 권한을 얻지 않고 수정, 포함 또는 교환되어서는 안됩니다.

[in] ulPrivs

글꼴을 로드하는 클라이언트에 의해 부과되는 포함 권한의 추가 제한을 나타내는 플래그입니다. 이 플래그에는 다음 값 중 하나가 있어야 합니다.

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

[out] pulStatus

TTLoadEmbeddedFont 요청에 대한 상태 정보를 포함하는 비트 필드에 대한 포인터입니다. 이 필드는 이 함수가 완료되면 채워지고 다음 값이 0개 이상일 수 있습니다.

값 의미
TTLOAD_FONT_SUBSETTED
 로드된 글꼴은 원래 글꼴의 하위 집합입니다.
TTLOAD_FONT_IN_SYSSTARTUP
 로드된 글꼴은 설치 가능으로 레이블이 지정되었으며 시작 시 사용할 수 있도록 레지스트리에 추가되었습니다.

[in] lpfnReadFromStream

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

[in] lpvReadStream

스트림(글꼴 구조)에 대한 포인터입니다.

[in, optional] szWinFamilyName

글꼴의 새 16비트 문자 유니코드 Microsoft Windows 패밀리 이름에 대한 포인터입니다. 기존 이름을 사용하려면 NULL 로 설정합니다. 로드 시 글꼴 이름을 변경할 때 이 매개 변수와 szMacFamilyName 매개 변수를 모두 제공해야 합니다.

[in, optional] szMacFamilyName

글꼴의 새 8비트 문자 Macintosh 패밀리 이름에 대한 포인터입니다. 기존 이름을 사용하려면 NULL 로 설정합니다. 로드 시 글꼴 이름을 변경할 때 이 매개 변수와 szWinFamilyName 매개 변수를 모두 제공해야 합니다.

[in, optional] pTTLoadInfo

포함된 글꼴 개체를 가져온 URL을 포함하는 TTLOADINFO 구조체에 대한 포인터입니다. 이 값이 TTEMBEDINFO 구조체에 포함된 값 중 하나와 일치하지 않으면 글꼴이 성공적으로 로드되지 않습니다.

반환 값

성공하면 E_NONE 반환합니다.

글꼴 로드에 성공하면 phFontReference로 표시된 글꼴 구조에서 szWinFamilyName 및 szMacFamilyName에서 참조되는 이름을 사용하여 글꼴 구조에서 생성됩니다. pulPrivStatus는 글꼴의 포함 권한을 나타내는 설정됩니다. 및 pulStatus는 글꼴 로드 작업에 대한 상태 정보를 나타내는 설정될 수 있습니다.

그렇지 않으면 함수 오류 메시지 포함에 설명된 오류 코드를 반환합니다.

설명

클라이언트가 시스템에 포함된 글꼴이 이미 설치되어 있는지 여부를 확인하는 데 도움을 주기 위해 글꼴 로드 함수는 시스템에 이름이 같은 글꼴(E_FONTNAMEALREADYEXISTS)이 있고 해당 글꼴에 포함된 글꼴(E_FONTALREADYEXISTS)과 동일한 체크섬이 있는지를 나타내는 오류 메시지를 반환합니다. 그러면 클라이언트에는 다음 두 가지 옵션이 있습니다.

  1. 설치된 글꼴이 포함된 글꼴과 실제로 동일하고 동일한 하위 집합을 커버한다고 가정합니다.
  2. 시스템에 이미 있는 글꼴과 호환되지 않도록 포함된 글꼴을 다른 이름으로 강제로 설치합니다.
설치하기 전에 포함된 글꼴의 이름을 변경하려면 클라이언트에서 8비트 문자 및 16비트 문자 이름 문자열을 매개 변수로 모두 제공해야 합니다. 새로 설치된 글꼴의 이름 테이블에서 글꼴 이름이 변경됩니다. 새 이름은 클라이언트에서만 사용할 수 있으며 사용자에게 열거되지 않습니다.

포함된 글꼴의 기존 이름을 사용하려면 이름 문자열 매개 변수를 NULL로 설정해야 합니다.

요구 사항

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

추가 정보

TTDeleteEmbeddedFont

TTEMBEDINFO

TTGetEmbeddingType

TTGetNewFontName

TTLOADINFO