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::AddRefHfont と IFont::ReleaseHfont を呼び出すことができます。


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