RemoveFontResourceExW 関数 (wingdi.h)

[アーティクル]
08/27/2023

RemoveFontResourceEx 関数は、指定したファイル内のフォントをシステムフォントテーブルから削除します。

構文

BOOL RemoveFontResourceExW(
  [in] LPCWSTR name,
  [in] DWORD   fl,
  [in] PVOID   pdv
);

パラメーター

[in] name

フォントリソースファイルに名前を付ける null で終わる文字列へのポインター。

[in] fl

システムから削除するフォントの特性。フォントを削除するには、 AddFontResourceEx 関数を使用してフォントを追加したときと同じフラグを使用する必要があります。詳細については、 AddFontResourceEx 関数を参照してください。

[in] pdv

予約済み。ゼロを指定してください。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。拡張エラー情報は使用できません。

解説

この関数は、指定されたフラグが AddFontResourceEx 関数を使用してフォントが追加されたときと同じ場合にのみ、フォントを削除します。

フォントを含む既存のフォントファイルを未処理の参照で置き換えようとすると、 RemoveFontResourceEx を呼び出しても使用されているため、元のフォントを削除できないことを示すエラーが表示されることがあります。アプリでフォントファイルを置き換える必要がある場合は、元のフォントのリソース数を 0 に減らすために、次のコード例に示すように、ループで RemoveFontResourceEx を呼び出します。エラーが引き続き発生する場合は、フォントファイルが他のセッションに読み込まれたままであることを示します。フォントがフォントレジストリに一覧表示されていないことを確認し、システムを再起動して、フォントがすべてのセッションからアンロードされるようにします。

メモ元のフォントファイルが使用されているアプリは、元のファイルに引き続きアクセスでき、フォントが再読み込みされるまで新しいフォントを使用しません。 AddFontResourceEx を呼び出してフォントを再読み込みします。 AddFontResourceEx は、次のコード例に示すように、RemoveFontResourceEx の呼び出しが成功した回数と同じ回数呼び出すようにすることをお勧めします。


int i = 0;
while( RemoveFontResourceEx( FontFile, FR_PRIVATE, 0 ) )
{
    i++;
}

// TODO: Replace font file

while( i-- )
{
    AddFontResourceEx( FontFile, FR_PRIVATE, 0 );
}

Note

wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RemoveFontResourceEx を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

RemoveFontResourceExW 関数 (wingdi.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース