ホーム › Graphics.Gdi › TTGetEmbeddedFontInfo

TTGetEmbeddedFontInfo

関数

埋め込みフォントの情報をストリームから取得する。

DLLt2embed.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// t2embed.dll
#include <windows.h>

INT TTGetEmbeddedFontInfo(
    TTEMBED_FLAGS ulFlags,
    DWORD* pulPrivStatus,
    FONT_LICENSE_PRIVS ulPrivs,
    DWORD* pulStatus,
    READEMBEDPROC lpfnReadFromStream,
    void* lpvReadStream,
    TTLOADINFO* pTTLoadInfo   // optional
);

パラメーター

名前

型

方向

説明

ulFlags

TTEMBED_FLAGS

要求を指定するフラグ。このフラグには、次の値のうち 0 個以上を指定できます。

値	意味
TTEMBED_EMBEDEUDC	関連付けられた EUDC フォントファイルのデータをフォント構造に含めます。
TTEMBED_RAW	完全な文字セットを含む非圧縮のフォント構造を返します。これがこの関数の既定の動作です。
TTEMBED_SUBSET	pusCharCodeSet または pulCharCodeSet パラメーターで示されたグリフのみを含むサブセット化されたフォントを返します。これらの文字コードは、パラメーターに応じて 16 ビット文字または UCS-4 文字として表す必要があります。
TTEMBED_TTCOMPRESSED	圧縮されたフォント構造を返します。

pulPrivStatus

DWORD*

out

完了時に、フォントの埋め込み権限を示します。指定可能な値の一覧を次に示します。

値	意味
EMBED_PREVIEWPRINT	プレビューおよび印刷のための埋め込み。
EMBED_EDITABLE	編集可能な埋め込み。
EMBED_INSTALLABLE	インストール可能な埋め込み。
EMBED_NOEMBEDDING	制限付きライセンスの埋め込み。

ulPrivs

FONT_LICENSE_PRIVS

クライアントによって課される、埋め込み権限のさらなる制限を示すフラグ。詳細については TTLoadEmbeddedFont を参照してください。

このフラグには、次の値のいずれかを指定する必要があります。

値	意味
LICENSE_PREVIEWPRINT	プレビューおよび印刷のための埋め込み。
LICENSE_EDITABLE	編集可能な埋め込み。
LICENSE_INSTALLABLE	インストール可能な埋め込み。
LICENSE_NOEMBEDDING	制限付きライセンスの埋め込み。
LICENSE_DEFAULT	既定の埋め込みレベルを使用します。

pulStatus

DWORD*

out

ステータス情報を格納するビットフィールドへのポインター。この関数の完了時に値が設定されます。ステータスには 0 または次の値を指定できます。

値	意味
TTLOAD_FONT_SUBSETTED	読み込まれたフォントは、元のフォントのサブセットです。

lpfnReadFromStream

READEMBEDPROC

[callback] ドキュメントストリームからフォント構造を読み取る、クライアント定義のコールバック関数へのポインター。

lpvReadStream

void*

現在は未定義です。ストリーム(フォント構造)へのポインター用に予約されています。

pTTLoadInfo

TTLOADINFO*

inoptional

埋め込みフォントオブジェクトの取得元 URL を含む TTLOADINFO 構造体へのポインター。

戻り値の型: INT

公式ドキュメント

埋め込みフォントに関する情報(埋め込みの許可状況など)を取得します。TTGetEmbeddedFontInfo は TTLoadEmbeddedFont と同じ処理を行いますが、埋め込みフォント用の内部データ構造の割り当ては行いません。

戻り値

成功した場合は E_NONE を返します。

pulPrivStatus が参照する場所には、フォントの埋め込み権限が示されます。pulStatus が参照する場所には、フォントのサブセットが埋め込まれているかどうかが示されます。

それ以外の場合は、Embedding-Function Error Messages に記載されているエラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// t2embed.dll
#include <windows.h>

INT TTGetEmbeddedFontInfo(
    TTEMBED_FLAGS ulFlags,
    DWORD* pulPrivStatus,
    FONT_LICENSE_PRIVS ulPrivs,
    DWORD* pulStatus,
    READEMBEDPROC lpfnReadFromStream,
    void* lpvReadStream,
    TTLOADINFO* pTTLoadInfo   // optional
);

[DllImport("t2embed.dll", ExactSpelling = true)]
static extern int TTGetEmbeddedFontInfo(
    uint ulFlags,   // TTEMBED_FLAGS
    out uint pulPrivStatus,   // DWORD* out
    uint ulPrivs,   // FONT_LICENSE_PRIVS
    out uint pulStatus,   // DWORD* out
    IntPtr lpfnReadFromStream,   // READEMBEDPROC
    IntPtr lpvReadStream,   // void*
    IntPtr pTTLoadInfo   // TTLOADINFO* optional
);

<DllImport("t2embed.dll", ExactSpelling:=True)>
Public Shared Function TTGetEmbeddedFontInfo(
    ulFlags As UInteger,   ' TTEMBED_FLAGS
    <Out> ByRef pulPrivStatus As UInteger,   ' DWORD* out
    ulPrivs As UInteger,   ' FONT_LICENSE_PRIVS
    <Out> ByRef pulStatus As UInteger,   ' DWORD* out
    lpfnReadFromStream As IntPtr,   ' READEMBEDPROC
    lpvReadStream As IntPtr,   ' void*
    pTTLoadInfo As IntPtr   ' TTLOADINFO* optional
) As Integer
End Function

' ulFlags : TTEMBED_FLAGS
' pulPrivStatus : DWORD* out
' ulPrivs : FONT_LICENSE_PRIVS
' pulStatus : DWORD* out
' lpfnReadFromStream : READEMBEDPROC
' lpvReadStream : void*
' pTTLoadInfo : TTLOADINFO* optional
Declare PtrSafe Function TTGetEmbeddedFontInfo Lib "t2embed" ( _
    ByVal ulFlags As Long, _
    ByRef pulPrivStatus As Long, _
    ByVal ulPrivs As Long, _
    ByRef pulStatus As Long, _
    ByVal lpfnReadFromStream As LongPtr, _
    ByVal lpvReadStream As LongPtr, _
    ByVal pTTLoadInfo As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

TTGetEmbeddedFontInfo = ctypes.windll.t2embed.TTGetEmbeddedFontInfo
TTGetEmbeddedFontInfo.restype = ctypes.c_int
TTGetEmbeddedFontInfo.argtypes = [
    wintypes.DWORD,  # ulFlags : TTEMBED_FLAGS
    ctypes.POINTER(wintypes.DWORD),  # pulPrivStatus : DWORD* out
    wintypes.DWORD,  # ulPrivs : FONT_LICENSE_PRIVS
    ctypes.POINTER(wintypes.DWORD),  # pulStatus : DWORD* out
    ctypes.c_void_p,  # lpfnReadFromStream : READEMBEDPROC
    ctypes.POINTER(None),  # lpvReadStream : void*
    ctypes.c_void_p,  # pTTLoadInfo : TTLOADINFO* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('t2embed.dll')
TTGetEmbeddedFontInfo = Fiddle::Function.new(
  lib['TTGetEmbeddedFontInfo'],
  [
    -Fiddle::TYPE_INT,  # ulFlags : TTEMBED_FLAGS
    Fiddle::TYPE_VOIDP,  # pulPrivStatus : DWORD* out
    -Fiddle::TYPE_INT,  # ulPrivs : FONT_LICENSE_PRIVS
    Fiddle::TYPE_VOIDP,  # pulStatus : DWORD* out
    Fiddle::TYPE_VOIDP,  # lpfnReadFromStream : READEMBEDPROC
    Fiddle::TYPE_VOIDP,  # lpvReadStream : void*
    Fiddle::TYPE_VOIDP,  # pTTLoadInfo : TTLOADINFO* optional
  ],
  Fiddle::TYPE_INT)

#[link(name = "t2embed")]
extern "system" {
    fn TTGetEmbeddedFontInfo(
        ulFlags: u32,  // TTEMBED_FLAGS
        pulPrivStatus: *mut u32,  // DWORD* out
        ulPrivs: u32,  // FONT_LICENSE_PRIVS
        pulStatus: *mut u32,  // DWORD* out
        lpfnReadFromStream: *const core::ffi::c_void,  // READEMBEDPROC
        lpvReadStream: *mut (),  // void*
        pTTLoadInfo: *mut TTLOADINFO  // TTLOADINFO* optional
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("t2embed.dll")]
public static extern int TTGetEmbeddedFontInfo(uint ulFlags, out uint pulPrivStatus, uint ulPrivs, out uint pulStatus, IntPtr lpfnReadFromStream, IntPtr lpvReadStream, IntPtr pTTLoadInfo);
"@
$api = Add-Type -MemberDefinition $sig -Name 't2embed_TTGetEmbeddedFontInfo' -Namespace Win32 -PassThru
# $api::TTGetEmbeddedFontInfo(ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, pTTLoadInfo)

#uselib "t2embed.dll"
#func global TTGetEmbeddedFontInfo "TTGetEmbeddedFontInfo" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; TTGetEmbeddedFontInfo ulFlags, varptr(pulPrivStatus), ulPrivs, varptr(pulStatus), lpfnReadFromStream, lpvReadStream, varptr(pTTLoadInfo)   ; 戻り値は stat
; ulFlags : TTEMBED_FLAGS -> "sptr"
; pulPrivStatus : DWORD* out -> "sptr"
; ulPrivs : FONT_LICENSE_PRIVS -> "sptr"
; pulStatus : DWORD* out -> "sptr"
; lpfnReadFromStream : READEMBEDPROC -> "sptr"
; lpvReadStream : void* -> "sptr"
; pTTLoadInfo : TTLOADINFO* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "t2embed.dll"
#cfunc global TTGetEmbeddedFontInfo "TTGetEmbeddedFontInfo" int, var, int, var, sptr, sptr, var
; res = TTGetEmbeddedFontInfo(ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, pTTLoadInfo)
; ulFlags : TTEMBED_FLAGS -> "int"
; pulPrivStatus : DWORD* out -> "var"
; ulPrivs : FONT_LICENSE_PRIVS -> "int"
; pulStatus : DWORD* out -> "var"
; lpfnReadFromStream : READEMBEDPROC -> "sptr"
; lpvReadStream : void* -> "sptr"
; pTTLoadInfo : TTLOADINFO* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "t2embed.dll"
#cfunc global TTGetEmbeddedFontInfo "TTGetEmbeddedFontInfo" int, sptr, int, sptr, sptr, sptr, sptr
; res = TTGetEmbeddedFontInfo(ulFlags, varptr(pulPrivStatus), ulPrivs, varptr(pulStatus), lpfnReadFromStream, lpvReadStream, varptr(pTTLoadInfo))
; ulFlags : TTEMBED_FLAGS -> "int"
; pulPrivStatus : DWORD* out -> "sptr"
; ulPrivs : FONT_LICENSE_PRIVS -> "int"
; pulStatus : DWORD* out -> "sptr"
; lpfnReadFromStream : READEMBEDPROC -> "sptr"
; lpvReadStream : void* -> "sptr"
; pTTLoadInfo : TTLOADINFO* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。