IFont::get_hFont メソッド (ocidl.h)

この font オブジェクトによって記述されたフォントへのハンドルを取得します。

構文

HRESULT get_hFont(
  [out] HFONT *phFont
);

パラメーター

[out] phFont

フォント ハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。 呼び出し元はこのリソースを所有していないため、フォントの破棄を試みてはなりません。

戻り値

メソッドは、E_UNEXPECTEDとE_OUTOFMEMORYの標準戻り値と、次の値をサポートしています。

リターン コード 説明
S_OK
フォント ハンドルが正常に取得されました。
E_POINTER
phFont パラメーターのアドレスが無効です。 たとえば、 NULL である可能性があります。

解説

呼び出し元へのメモ

font オブジェクトは HFONT の所有権を保持し、事前の通知なしにいつでも破棄できます。 呼び出し元がこのフォントを一定期間セキュリティで保護する必要がある場合は、 IFont::AddRefHfontIFont::ReleaseHfont を呼び出すことができます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

関連項目

IFont

IFont::AddRefHfont

IFont::ReleaseHfont