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 또는 다음 값으로 설정할 수 있습니다.
값 | 의미 |
---|---|
|
글꼴이 사용자에게 열거되지 않도록 로드합니다. 글꼴을 설치할 수 없는 경우 비공개로 유지됩니다. |
[out] pulPrivStatus
글꼴의 포함 권한을 나타내는 플래그에 대한 포인터입니다. 이 플래그는 이 함수가 완료될 때 작성되며 다음 값 중 하나를 가질 수 있습니다. 이 함수는 부여된 최소 제한 라이선스를 반환합니다.
[in] ulPrivs
글꼴을 로드하는 클라이언트에 의해 부과되는 포함 권한의 추가 제한을 나타내는 플래그입니다. 이 플래그에는 다음 값 중 하나가 있어야 합니다.
값 | 의미 |
---|---|
|
미리 보기 및 인쇄 포함 |
|
편집 가능한 포함. |
|
설치 가능한 포함. |
|
제한된 라이선스 포함. |
|
기본 포함 수준을 사용합니다. |
[out] pulStatus
TTLoadEmbeddedFont 요청에 대한 상태 정보를 포함하는 비트 필드에 대한 포인터입니다. 이 필드는 이 함수가 완료되면 채워지고 다음 값이 0개 이상일 수 있습니다.
값 | 의미 |
---|---|
|
로드된 글꼴은 원래 글꼴의 하위 집합입니다. |
|
로드된 글꼴은 설치 가능으로 레이블이 지정되었으며 시작 시 사용할 수 있도록 레지스트리에 추가되었습니다. |
[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)과 동일한 체크섬이 있는지를 나타내는 오류 메시지를 반환합니다. 그러면 클라이언트에는 다음 두 가지 옵션이 있습니다.
- 설치된 글꼴이 포함된 글꼴과 실제로 동일하고 동일한 하위 집합을 커버한다고 가정합니다.
- 시스템에 이미 있는 글꼴과 호환되지 않도록 포함된 글꼴을 다른 이름으로 강제로 설치합니다.
포함된 글꼴의 기존 이름을 사용하려면 이름 문자열 매개 변수를 NULL로 설정해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | t2embapi.h |
라이브러리 | T2embed.lib |
DLL | T2embed.dll |